deckrd

|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.)

1. Download the zip archive from deckrd - release
2. 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:

• deckrd plugin
• deckrd-coder plugin
• User Guide

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