morethanadiagnosis-hub/openspec/ai-commands.md
2025-11-17 22:57:40 +00:00

30 lines
1.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AI Slash Commands Workflow
These commands align with OpenSpec and can be used with Claude Code, Codex, Copilot, or similar assistants. Include them in PR descriptions, issues, or comments.
Core commands
- `/propose <title> [scope=spec|infra|policy] [labels=a11y,compliance] [assignees=@owner] [model=claude|gpt|copilot]`
- Scaffolds `openspec/changes/YYYY-MM-DD-title/proposal.md` from the template
- `/review areas=accessibility,compliance,security,mobile,web,backend`
- Summons focused review checklists and routes to domain owners
- `/apply spec=openspec/specs/<target>.md [pr=<link>]`
- Moves accepted sections into the target spec; opens/updates PR
- `/archive reason="accepted into <spec>" link=<PR>`
- Finalizes the change and records traceability
Helpful commands
- `/assign @user1 @user2` — set reviewers/owners
- `/estimate 5d` — initial tshirt or time estimate
- `/plan` — generate a milestone/task breakdown tied to the spec
- `/generate tests scope=<module>` — create or update test skeletons per acceptance criteria
Usage examples
- Start a feature: `/propose Community Forum MVP scope=spec labels=a11y,compliance,security model=claude`
- Ask for targeted review: `/review areas=accessibility,compliance`
- Apply after approval: `/apply spec=openspec/specs/feature-forum.md pr=<link>`
- Archive the change: `/archive reason="merged" link=<PR>`
Agent notes
- Keep assistants grounded in `openspec/project.md` guardrails.
- When generating code, require an approved spec link in the PR description.