Back to list
aglabo

deckrd

by aglabo

Document-Driven Development framework for AI-assisted BDD workflows

1🍴 0📅 Jan 14, 2026

SKILL.md


name: deckrd description: "Use when structuring requirements, specifications, or tasks. Enforces stepwise derivation and phase integrity."

Deckrd - Your Goals to Tasks framework

Deckrd is a document-centered framework for structuring and refining ideas through iterative discussion with AI. It guides the creation of requirements, decisions, specifications, and implementation plans as derived documents, not final outputs. Each document captures reasoning at a specific stage, preserving context and intent. Through a strict, state-driven workflow, these documents are progressively shaped into executable development tasks. Deckrd enables documentation to function as a practical engine for action, not just description.

Commands

CommandDescription
init <ns>/<mod>Initialize module directory and session
reqDerive requirements from goals
drManage Decision Records (req step only)
dr --addAppend a new Decision Record
specDerive specifications from requirements
implDerive implementation plan from specifications
tasksDerive executable tasks from implementation
statusDisplay current workflow progress and status

Session Resolution

Session state is stored in docs/.deckrd/.session.json.

Before executing any command:

  1. Read .session.json to get active module and current step
  2. Validate the command matches expected workflow progression
  3. Load the appropriate reference from references/commands/

Reference selection:

Current StateNext CommandLoad Reference
(none)initcommands/init.md
init completedreqcommands/req.md
req completedspeccommands/spec.md
spec completedimplcommands/impl.md
impl completedtaskscommands/tasks.md

For workflow overview: workflow.md For session management details: session.md For status command: commands/status.md

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon