deckrd

Deckrd

Goals → Requirements → Specifications → Implementation → Tasks

Skill Announcement (REQUIRED)

Before every command, YOU MUST output:

"I am executing /deckrd [COMMAND] for module [MODULE_NAME]."

No announcement = violation. Restart with announcement.

Before Every Command (REQUIRED)

1. Read .local/deckrd/session.json — confirm active module and current step
2. Validate command order — if out of order, STOP and report
3. Load the reference listed below — NEVER proceed without it

Reference selection:

Current State	Next Command	Reference
(none)	init	commands/init.md
init completed	module	commands/module.md
module completed	req	commands/req.md
req completed	spec	commands/spec.md
spec completed	impl	commands/impl.md
impl completed	tasks	commands/tasks.md
any	review	commands/review.md
init completed	rev	commands/rev.md

Gate Rule: each command requires the previous command's document. No skipping.

project is project-scoped and can run any time. See commands/project.md. Full command list: commands/index.md Workflow overview: workflow.md Session management: session.md

Examples

New feature from goals:

"I want to add a retry mechanism to the HTTP client." → /deckrd init my-project/http-retry → req → spec → impl → tasks

Existing code, no docs:

"This module has no documentation. Reverse-engineer it." → /deckrd rev --to req → spec → impl → tasks

Small bug fix:

Troubleshooting

Session not found Cause: init has not been run, or wrong directory. Solution: Run /deckrd init <project> <project-type> first.

Command out of order Cause: Trying to run spec before req, etc. Solution: Check /deckrd status to see the current step, then run the correct next command.

Gate Rule violation Cause: Required document from previous step is missing. Solution: Complete the missing step before proceeding. Use /deckrd status to confirm.