Rules & Skills

AIDK uses two key mechanisms to guide the AI: Rules and Skills. Both reside in the .agent/ directory.

Rules

Rules are .md files in .agent/rules/. The AI reads them before every task to understand project constraints and standards.

Rule Structure

# Rule Name

## Description
Brief description of what this rule enforces.

## Mandatory Guidelines
- Rule 1
- Rule 2

## Correct Example
...

## Incorrect Example
...

Default Rules

Rule	Priority	Description
0-force-rule.md	0 (highest)	Forces the AI to review all rules/skills before starting any task
2-dotenv-environments.md	2	Environment variable configuration standards using .env files
3-coding-style.md	3	Coding style rules (file size limits, immutability, etc.)

Priority Order

Rules with lower numbers take precedence. For example, 0-force-rule.md is always applied first.

---

Skills

Skills are directories in .agent/skills/, each containing at least a SKILL.md file. Skills provide technology-specific or task-specific guidance.

Skill Structure

.agent/skills/
└── my-skill/
    ├── SKILL.md        # Main instructions (required)
    ├── examples/       # Reference examples (optional)
    └── templates/      # File templates (optional)

SKILL.md Frontmatter

---
name: my-skill
description: >
  Describe when this skill should be used.
  The AI reads this to decide whether to apply the skill.
---

Available Skills

Skill	When to use
create-skill	Creating, writing, or authoring a new Agent Skill
cxl-ansible	Writing Ansible playbooks
cxl-aws-architecture	Designing AWS architectures
cxl-brainstorming	Before any creative/constructive work
cxl-coding-standards	TypeScript/JavaScript/React standards
cxl-docusaurus-setup	Creating/updating Docusaurus doc sites
cxl-dynamodb	DynamoDB data modeling
cxl-fastapi	Building REST APIs with FastAPI
cxl-gitignore	Create/update .gitignore files
cxl-laravel	Developing Laravel 11+ applications
cxl-php	PHP 8.3+ coding standards
cxl-postgres-patterns	Schema design and PostgreSQL queries
cxl-python	Python coding standards
cxl-report-po	Create structured PA/DA reports
cxl-security-review	Security review when adding auth/APIs
cxl-seo	SEO optimization
cxl-terraform	Working with Terraform/OpenTofu

Creating a New Skill

aidk add skill my-new-skill
# Creates: .agent/skills/my-new-skill/SKILL.md

Then edit SKILL.md according to your project's specific needs.

---

Workflows

Workflows are .md files in .agent/workflows/ that define slash-command-driven processes.

Default Workflows

Workflow	Slash command	Description
capture-knowledge.md	/capture-knowledge	Document a code entry point in knowledge docs
check-implementation.md	/check-implementation	Compare implementation with design and requirements
code-review.md	/code-review	Code review before pushing
create-report-po.md	/create-report-po	Create PA/DA report from Notion
debug.md	/debug	Root cause analysis before code changes
execute-plan.md	/execute-plan	Step-by-step execution of a feature plan
make-release.md	/make-release	Make a new release for the CLX AI Kit
new-requirement.md	/new-requirement	Generate docs from requirements to planning
review-deployment.md	/review-deployment	Review deployment strategy
review-design.md	/review-design	Review feature design
review-implementation.md	/review-implementation	Review feature implementation
review-monitoring.md	/review-monitoring	Review monitoring and observability setup
review-requirements.md	/review-requirements	Review feature requirements
simplify-implementation.md	/simplify-implementation	Simplify existing code to reduce complexity
update-docs.md	/update-docs	Update all README files and Docusaurus site
update-planning.md	/update-planning	Update planning docs
update-requirement.md	/update-requirement	Update existing feature documentation
write-tests.md	/write-tests	Write tests for a new feature