Skip to content

chore: add takt workflow config#153

Merged
coji merged 1 commit into
mainfrom
chore/takt-workflow-config
Mar 26, 2026
Merged

chore: add takt workflow config#153
coji merged 1 commit into
mainfrom
chore/takt-workflow-config

Conversation

@coji
Copy link
Copy Markdown
Owner

@coji coji commented Mar 26, 2026

Summary

  • Add reusable takt workflow definitions for multi-agent development
  • Two pieces: spec-implement-accept (Codex review → Cursor implement → Claude Code acceptance) and implement-step (implement → parallel review → fix loop)
  • Custom facets: acceptor/simplifier personas, instructions, policies, output contracts
  • config.yaml excluded via .gitignore (personal provider/model settings)

Context

These were created and refined during the waitForRun implementation (#151). The spec-review rules were updated based on learnings from 5 consecutive ABORTs (see the takt analyzer findings).

🤖 Generated with Claude Code

Summary by CodeRabbit

リリースノート

  • ドキュメント

    • 開発プロセスおよびワークフロー管理用の内部ドキュメントテンプレートを追加しました。
  • チョア

    • プロジェクト管理ツールの設定ファイルおよびプロセス定義ファイルをセットアップしました。

Add reusable takt workflow definitions for multi-agent development:
- spec-implement-accept piece (Codex review → Cursor implement → Claude Code acceptance)
- implement-step piece (implement → parallel review → fix loop)
- Custom facets: acceptor/simplifier personas, instructions, policies, output contracts

config.yaml is excluded (.gitignore) as it contains personal provider/model settings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Mar 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments
Project Deployment Actions Updated (UTC)
durably-demo Ignored Ignored Mar 26, 2026 1:36pm
durably-demo-vercel-turso Ignored Ignored Mar 26, 2026 1:36pm

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Mar 26, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 07b82a34-807b-4725-b0d8-189f3e6c724c

📥 Commits

Reviewing files that changed from the base of the PR and between 71130d4 and ef5cb9a.

📒 Files selected for processing (12)
  • .takt/.gitignore
  • .takt/facets/instructions/acceptance.md
  • .takt/facets/instructions/simplify.md
  • .takt/facets/instructions/spec-review.md
  • .takt/facets/knowledge/implementation-plan.md
  • .takt/facets/output-contracts/acceptance-report.md
  • .takt/facets/output-contracts/spec-review-report.md
  • .takt/facets/personas/acceptor.md
  • .takt/facets/personas/simplifier.md
  • .takt/facets/policies/step-implementation.md
  • .takt/pieces/implement-step.yaml
  • .takt/pieces/spec-implement-accept.yaml

📝 Walkthrough

Walkthrough

Takt ワークフロー管理システムの新規セットアップとして、.takt ディレクトリにおいて、仕様レビュー・実装・受け入れ検査・修正・簡素化のサイクルを定義する設定ファイル、ペルソナ定義、指示書、出力テンプレート、ポリシーを一括追加した。

Changes

Cohort / File(s) Summary
Configuration
.takt/.gitignore
デフォルトで全ファイルを無視し、.gitignore と特定の pieces/ および facets/ サブディレクトリ(personas、policies、knowledge、instructions、output-contracts)を選別。
Instruction Documents
.takt/facets/instructions/acceptance.md, simplify.md, spec-review.md
受け入れ検査、コード簡素化、仕様レビュー各プロセスの手順書。検証手順、チェックリスト、完了条件の確認方法を記載。
Knowledge & Policies
.takt/facets/knowledge/implementation-plan.md, .takt/facets/policies/step-implementation.md
実装計画のコンテキスト定義と、個別ステップの実装ポリシー(スコープ制約、品質期待値、禁止事項)。
Personas
.takt/facets/personas/acceptor.md, simplifier.md
Acceptor(受け入れ検査官)および Simplifier(簡素化エージェント)の責務、行動姿勢、判定基準を定義。
Output Contracts
.takt/facets/output-contracts/acceptance-report.md, spec-review-report.md
受け入れ検査報告書と仕様レビュー報告書のテンプレート。判定結果、チェックリスト、検出結果セクションを含む。
Workflow Pieces
.takt/pieces/implement-step.yaml, spec-implement-accept.yaml
実装ステップの実行フロー(実装 → レビュアー → 修正ループ)と、仕様レビュー → 実装 → 受け入れ → 修正 → 簡素化の統合ワークフロー(最大20サイクル、ループ監視による収束判定)。

Sequence Diagram(s)

sequenceDiagram
    participant Client
    participant SpecReviewer as Spec Reviewer
    participant Implementer
    participant Acceptor as Acceptance Inspector
    participant Validator as Validator
    participant Simplifier

    Client->>SpecReviewer: Step order (order.md)
    SpecReviewer->>SpecReviewer: Review spec clarity & coverage
    SpecReviewer-->>Client: spec-review-report.md
    
    Client->>Implementer: Proceed to implement
    Implementer->>Implementer: Implement changes
    Implementer->>Validator: Run pnpm validate
    Validator-->>Implementer: Validation result
    Implementer-->>Client: Implementation complete
    
    Client->>Acceptor: Submit for acceptance check
    Acceptor->>Acceptor: Verify completion conditions
    Acceptor->>Validator: Run pnpm validate
    Validator-->>Acceptor: Validation result
    Acceptor->>Acceptor: Check scope (git diff)
    Acceptor-->>Client: acceptance-report.md
    
    alt Acceptance approved
        Client->>Simplifier: Proceed to simplify
        Simplifier->>Simplifier: Simplify code
        Simplifier->>Validator: Run pnpm validate
        Validator-->>Simplifier: Validation result
        Simplifier-->>Client: COMPLETE
    else Acceptance rejected
        Client->>Implementer: Fix issues
        Implementer->>Implementer: Apply corrections
        Implementer-->>Acceptor: Resubmit for check
    end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 新しいワークフローがぴょんと現れて、
仕様から実装、検査から修正へと、
ステップバイステップで進むその道。
受け入れ検査官が眼光鋭く見守り、
簡素化の魔法で、コードがすっきり整う。
Takt の舞台、今、幕開けだ!✨

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/takt-workflow-config

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coji coji merged commit 33b4fc3 into main Mar 26, 2026
5 checks passed
@coji coji deleted the chore/takt-workflow-config branch March 26, 2026 13:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant