| title | deckrd - "Your Goals to Task" framework |
|---|---|
| description | A document-driven workflow for progressively documenting and organizing requirements through implementation decisions. |
|English|日本語|
deckrd is a document-driven workflow for progressively documenting and organizing requirements through implementation decisions.
It manages the following documents as separate, distinct layers:
- requirements (demands and conditions)
- decision-records (history of design decisions)
- specifications (detailed specifications)
- implementation (implementation decisions and guidelines)
- tasks (implementation tasks)
Prerequisites: AI execution environment (Claude Code, etc.) and access to a compatible LLM
deckrd consists of three integrated components that cover the full development lifecycle:
| Component | Command | Role |
|---|---|---|
| deckrd | /deckrd <command> |
Planning: Goals → Tasks (design phase) |
| bdd-coder | /bdd-coder:bdd-coder <task-id> |
BDD-style implementation (coding phase) |
| IDD Framework | /idd/issue:new, /idd-pr |
GitHub Issues / PRs (execution phase) |
Phase 1: Issue Definition (IDD)
/idd/issue:new → GitHub Issue → Branch
Phase 2: Planning (deckrd)
/deckrd init → module → req → [dr] → spec → impl → tasks
Phase 3: Implementation & Release (bdd-coder + IDD)
/bdd-coder:bdd-coder T01 → BDD impl → /idd-commit-message → /idd-pr → PR
# gh skill
gh skill install aglabo/deckrd
# npx skills
npx skills add aglabo/deckrd# Add marketplace if needed
claude plugin marketplace add aglabo/deckrd
# Install deckrd
claude plugin install deckrd@deckrd
# Install bdd-coder (optional)
claude plugin install bdd-coder@deckrd# Phase 1: Create Issue (IDD)
/idd/issue:new
# Phase 2: Plan with deckrd
/deckrd init myproject shell
/deckrd module myproject/feature # or: /deckrd module feature
/deckrd req
/deckrd spec
/deckrd impl
/deckrd tasks
# Phase 3: Implement and release (bdd-coder + IDD)
/bdd-coder:bdd-coder T01-01 # Implement task T01-01
/bdd-coder:bdd-coder T01-02 # Implement task T01-02
# ... (run for each task)
/idd-commit-message
git commit -m "..."
/idd-pr| Command | Description |
|---|---|
init <project> <project-type> |
Bootstrap project (run once per project) |
init <project> <type> --force |
Same, and overwrite every deployed asset |
project --project <name> |
Update project settings (type, language, AI model) |
module <namespace>/<module> |
Create module directory and set as active module |
req |
Create requirements definition |
spec |
Create specification document |
impl |
Create implementation criteria |
tasks |
Create implementation task list |
dr --add |
Record Decision Records (optional) |
dr --refine [DR-ID ...] |
Rewrite existing DRs for readability (optional) |
review |
Review a document with an independent second opinion |
status |
Check workflow progress |
update [--update] |
List missing or outdated assets (--update to apply) |
rev [--from code] [--to <phase>] |
Reverse-engineer existing code into docs |
review <phase> |
Review a document (any phase) |
For details, see:
The implementation layer is not a place to write actual code. It records the following aspects of implementation decisions:
- Rationale for choosing implementation strategies
- Decision basis when multiple options exist
- Constraints (compatibility, performance, dependencies, etc.)
- Items intentionally decided "not to implement"
deckrd does not aim to:
- Automatically generate code
- Enforce implementation details
- Impose a single development methodology (TDD / BDD, etc.)
deckrd is purely an assistive framework for organizing thoughts and decisions.
bdd-coder is an optional skill for deckrd users.
It takes tasks.md generated by deckrd and automatically implements them using a strict BDD (Behavior-Driven Development) process.
Completely optional: You can use deckrd alone to generate tasks and implement them manually at your own pace.
bdd-coder is included in the deckrd marketplace and installed alongside deckrd:
# gh skill (installs both deckrd and bdd-coder)
gh skill install aglabo/deckrd
# or install bdd-coder individually via claude plugin
claude plugin install bdd-coder@deckrd# Step 1: Plan and document with deckrd
/deckrd init myproject shell
/deckrd module myproject/feature
/deckrd req
/deckrd spec
/deckrd impl
/deckrd tasks
# Step 2: Implement automatically with bdd-coder (optional)
/bdd-coder:bdd-coder T01-01 # Implement task T01-01
/bdd-coder:bdd-coder T01-02 # Implement task T01-02
# ... (run for each task)
# Step 3: Commit and create PR (IDD)
/idd-commit-message
git commit -m "..."
/idd-pr- Prerequisites: deckrd's
tasks.mdis required. Run deckrd first. - Implementation Flow: Automatically executes Red-Green-Refactor cycle (test → implement → refactor)
- Quality Gates: Automatically validates tests, linting, and type checking
- Commit: Execute manually (not automatic)