|English|日本語|
deckrd - "Your Goals to Task" framework
About deckrd
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
The Three Components
deckrd consists of three integrated components that cover the full development lifecycle:
| Component | Command | Role |
|---|
| deckrd | /deckrd <command> | Planning: Goals → Tasks (design phase) |
| deckrd-coder | /deckrd-coder <task-id> | BDD-style implementation (coding phase) |
| IDD Framework | /idd/issue:new, /idd-pr | GitHub Issues / PRs (execution phase) |
Complete Workflow
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 (deckrd-coder + IDD)
/deckrd-coder T01 → BDD impl → /idd-commit-message → /idd-pr → PR
Installation
Using as Claude Code plugins
# Add marketplace if needed
claude plugin marketplace add aglabo/deckrd
# Install deckrd
claude plugin install deckrd@deckrd
Agent Skills (codex, etc.)
- Download the zip archive from deckrd - release
- Copy the
deckrd directory to your Agent Skills directory
Quick Start
# Phase 1: Create Issue (IDD)
/idd/issue:new
# Phase 2: Plan with deckrd
/deckrd init myProject shell
/deckrd module myProject/feature
/deckrd req
/deckrd spec
/deckrd impl
/deckrd tasks
# Phase 3: Implement and release (deckrd-coder + IDD)
/deckrd-coder T01-01 # Implement task T01-01
/deckrd-coder T01-02 # Implement task T01-02
# ... (run for each task)
/idd-commit-message
git commit -m "..."
/idd-pr
Key Commands
| Command | Description |
|---|
init <project> <project-type> | Bootstrap project (run once per project) |
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) |
status | Check workflow progress |
For details, see:
Important Notes
About implementation
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"
What deckrd Does NOT Do
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.
deckrd-coder Plugin
About deckrd-coder
deckrd-coder is an optional plugin 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.
Installation
deckrd-coder is available from the deckrd marketplace:
claude plugin install deckrd-coder@deckrd
Basic Usage