Skip to content
aglaboPublic

About

Document-Driven Development framework for AI-assisted BDD workflows

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

228 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
title deckrd - "Your Goals to Task" framework
description A document-driven workflow for progressively documenting and organizing requirements through implementation decisions.

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

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 (bdd-coder + IDD)
  /bdd-coder:bdd-coder T01 → BDD impl → /idd-commit-message → /idd-pr → PR

Installation

Using as Agent Skills (Claude Code, Codex, etc.)

# gh skill
gh skill install aglabo/deckrd

# npx skills
npx skills add aglabo/deckrd

Using as Claude Code plugins

# 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

Quick Start

# 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

Key Commands

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:

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.


bdd-coder Skill

About bdd-coder

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.

Installation

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

Basic Usage

# 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

Important Notes

  • Prerequisites: deckrd's tasks.md is 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)

Documentation

User Guides

Developer Guides

Contributing

Changelog

About

Document-Driven Development framework for AI-assisted BDD workflows

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages