Contributing to agnostic-planning-skills

Contributions are welcome. This repository follows a Markdown + YAML frontmatter architecture for skills and agents.

Getting Started

1. Clone the repository
2. Review docs/architecture.md for structural conventions

Adding a New Skill

1. Create the directory: skills/<category>/<skill-name>/
2. Create SKILL.md following the conventions in docs/architecture.md
3. Add companion files (templates, examples, heuristics) as needed
4. Register the skill in tile.json
5. Add the skill to docs/reference/skill-catalog.md
6. Add the skill to docs/reference/integration-matrix.md

Adding a New Agent

1. Create the directory: agents/<agent-name>/
2. Create SKILL.md with phases, hard gates, decision gates, and error recovery
3. Register the agent in agents.json
4. Add the agent to docs/reference/skill-catalog.md
5. Update docs/agent-guide.md with the new agent's workflow

Conventions

• All generated artifacts in English unless the user explicitly requests another language
• Skill names match directory names (kebab-case)
• Frontmatter description starts with action-oriented trigger language
• HARD-GATE rules go in fenced code blocks
• Keep public docs consistent with tile.json and agents.json