Agentic Workflow Foundation Kit

AI エージェント（Cursor Agent など）を開発プロジェクトに組み込むための基盤ファイル群を、統一設計書 + seed manifest + templates + project manifest から決定論的に生成・監査するツールキットです。

このリポジトリは「生成される基盤」そのものではなく、基盤を生成するための Cursor Skill と Python エンジン一式です。対象プロジェクトで agentic-workflow-foundation を実行すると、AGENTS.md、Cursor Rules、Hooks、運用 docs、Domain 層ドキュメント、セッション管理スキル、GitHub 連携スキル、多角評価スキル、wrapper スクリプト、任意の CodeRabbit / review スキル設定がワークスペース直下に展開されます。

本リポジトリは dogfooding 構成です。キット本体（.cursor/skills/agentic-workflow-foundation / agentic-workflow-engine）に加え、ルート直下に manifest.yaml と生成物（AGENTS.md、docs/、bin/ 等）が同居しています。生成物の変更は manifest / templates 経由の再生成が正規ルートです。

できること

領域	生成・管理するもの
Context / Meta	`AGENTS.md`、`CLAUDE.md`、`docs/AGENT_RUNBOOK.md`、`docs/QUALITY_GATE.md`
Constraints	`.cursor/rules/00-init.mdc`、`01-critical-constraints.mdc`、`02-agent-conduct.mdc`
Capabilities	`session-planning`、`session-handover`、任意の `workflow-orchestrator`、`requirement-analysis`、`maintenance-docs-workflow`、`maintenance-gotchas-workflow`、`agent-code-review`、`agent-github-pr`、`agent-github-issue`、`cross-repository-knowledge-link`、`deep-thinking`、`agent-kaizen`
Automation	`.cursor/hooks/*.sh`、`.cursor/hooks.json`、Git write guard、Context Budget Hooks（compact 観測・会話ログ含む）、workflow / artifact / archive ゲート
Project Docs (Meta)	`docs/AGENT_RUNBOOK.md`、`docs/QUALITY_GATE.md`、`docs/CONTEXT_BUDGET.md`、`docs/references/context-budget-internals.md`、`docs/DECISIONS.md`、`docs/GOTCHAS.md`
Project Docs (Domain)	`docs/spec.md`、`docs/spec/`、`docs/architecture.md`、`docs/api.md`、`docs/data-models.md`、`docs/coding-standards.md`、`docs/workflows.md`
Tech Stack	`docs/tech-stack.md`（Domain 層）、quality gate contract、CodeRabbit / Domain docs の自動解決
Agent Workflow	任意の `docs/agent-tasks/agent-workflow/**`（6 段階：①〜⑥）、`docs/agent-tasks/{reports,maintenance-docs}/`、`workflow-orchestrator`、`requirement-analysis`、`maintenance-docs-workflow`、`maintenance-gotchas-workflow`
Multi-perspective	任意の `.cursor/skills/deep-thinking/**`（A/B 並列分析 + C 統合裁定）
GitHub Wrappers	`bin/_github-app-auth.sh`、`bin/github-pr-create-safe`、任意の `bin/github-pr-{reviews,comment,reply}-safe`、`bin/github-issue-{create,read}-safe`
Cross-Repo	任意の `.cursor/skills/cross-repository-knowledge-link/**`、`bin/cross-repo-sync-safe`
Review Integration	任意の `.coderabbit.yaml` と CodeRabbit path instructions

docs/DECISIONS.md、docs/GOTCHAS.md および Domain 層ドキュメント群（docs/spec.md 等）は追記ログまたは PO 充実用のため、存在しない場合だけ初期生成する seed モードです。.gitignore と .cursorignore は既存内容を保持し、marker_id: agentic-foundation の管理ブロックだけを更新します。

現行アーキテクチャ

immutable upstream SoT
  .cursor/docs/AI_AGENT_UNIFIED_DESIGN.md
  .cursor/docs/AI_BUSINESS_AGENT_SUITE.md
        │
        ▼
agentic-workflow-foundation（What）
  seed manifest + templates + resolver scripts
        │
        ├─ bootstrap: root manifest.yaml を生成 / framework 同期
        ├─ ingest: tech_stack を Domain サマリとして root manifest.yaml へ取り込み
        ├─ contract: tech stack SoT → LLM draft → validate / PO approval → tech_contract pin
        ├─ resolve: 承認済み tech_contract を quality gate / runtime / review / domain docs へ投影
        ▼
run_resolved_engine.py
  seed + upstream metadata + root manifest overlay から
  一時 resolved skill-dir を作成
        │
        ▼
agentic-workflow-engine（How）
  generate.py / audit.py / genlib.py
        │
        ▼
対象プロジェクトの基盤ファイル群

中核は What / How の分離です。

agentic-workflow-foundation は、どのファイルをどの内容で出すかを持つ設定スキルです。統一設計書、seed manifest.yaml、templates/、project manifest の重ね合わせ、tech stack の事実取り込み、承認済み tech_contract の検証・投影を担当します。G-* / runtime / CodeRabbit / Domain docs / Provisioning の技術依存入力は tech_contract のみです。

agentic-workflow-engine は、解決済みの manifest.yaml + templates/ だけを受け取る生成・監査エンジンです。統一設計書や root manifest.yaml を直接読まず、render / seed / marker モードでファイルをバイト一致再現します。

リポジトリ構成

agentic-workflow-foundation-kit/
├── README.md                          # 本ファイル（手管理）
├── setup.md                           # 外部サービス・Cursor 設定手順
├── LICENSE
├── Makefile                           # CLI 依存の install / check
├── init.yaml                          # 初期入力 SoT（name / tech_stack_design / context_budget。生成対象外）
├── manifest.yaml                      # 正式 project manifest（スキル実行で生成）
│
├── AGENTS.md                          ┐
├── CLAUDE.md                          │
├── .coderabbit.yaml                   │
├── bin/                               │ 生成物（dogfooding）
│   ├── _github-app-auth.sh            │
│   ├── github-pr-*-safe               │
│   ├── github-issue-*-safe            │
│   └── cross-repo-sync-safe           │
├── docs/                              │
│   ├── AGENT_RUNBOOK.md               │
│   ├── QUALITY_GATE.md                │
│   ├── CONTEXT_BUDGET.md              │
│   ├── references/                    │
│   ├── tech-stack.md                  │
│   ├── DECISIONS.md / GOTCHAS.md      │
│   ├── spec.md / spec/                │
│   ├── architecture.md / api.md / …   │
│   └── agent-tasks/                   ┘
│
└── .cursor/
    ├── docs/
    │   ├── AI_AGENT_UNIFIED_DESIGN.md        # immutable upstream SoT
    │   ├── AI_BUSINESS_AGENT_SUITE.md        # immutable upstream SoT
    │   └── TECHNOLOGY_STACK_UNIFIED_DESIGN.md # project ごとの tech stack 入力
    ├── hooks/                                # 生成 Hook スクリプト
    ├── hooks.json
    ├── rules/                                # 生成 Cursor Rules
    └── skills/
        ├── agentic-workflow-foundation/      # ── キット本体（What）──
        │   ├── SKILL.md
        │   ├── manifest.yaml                 # seed manifest
        │   ├── templates/
        │   │   ├── AGENTS.md.template
        │   │   ├── CLAUDE.md.template
        │   │   ├── coderabbit.yaml.template
        │   │   ├── hooks.json.template
        │   │   ├── gitignore.block.template
        │   │   ├── cursorignore.block.template
        │   │   ├── rules/                    # 00-init 〜 02-agent-conduct
        │   │   ├── hooks/                    # guard-git-write, session-*,
        │   │   │                             # budget-*, compact-observer, response-tracker
        │   │   ├── docs/                     # AGENT_RUNBOOK, QUALITY_GATE, tech-stack,
        │   │   │                             # CONTEXT_BUDGET, references/, DECISIONS, GOTCHAS,
        │   │   │                             # spec, spec/README, architecture, api,
        │   │   │                             # data-models, coding-standards, workflows,
        │   │   │                             # agent-tasks/**
        │   │   ├── skills/                   # session-planning, session-handover,
        │   │   │                             # agent-code-review,
        │   │   │                             # agent-github-pr, agent-github-issue,
        │   │   │                             # workflow-orchestrator, requirement-analysis,
        │   │   │                             # maintenance-*-workflow, cross-repository-
        │   │   │                             # knowledge-link, deep-thinking, agent-kaizen
        │   │   └── bin/                      # _github-app-auth.sh, github-*-safe,
        │   │                                 # cross-repo-sync-safe
        │   ├── references/
        │   │   ├── source-mapping.md
        │   │   └── design-conformance.md
        │   └── scripts/
        │       ├── run_resolved_engine.py
        │       ├── apply_kit_init.py
        │       ├── ingest_tech_stack.py
        │       ├── resolve_budget_thresholds.py
        │       ├── resolve_quality_gate.py
        │       ├── resolve_coderabbit.py
        │       ├── resolve_domain_docs.py
        │       ├── tech_contract.py
        │       ├── provision_runtime.py
        │       ├── runtime_plan.py
        │       ├── materialize_runtime.py
        │       ├── check_tech_stack_conformance.py
        │       ├── validate_deep_thinking.py
        │       ├── validate_requirement_analysis.py
        │       └── test_*.py
        ├── agentic-workflow-engine/          # ── キット本体（How）──
        │   ├── SKILL.md
        │   └── scripts/
        │       ├── genlib.py
        │       ├── generate.py
        │       └── audit.py
        │
        └── （生成スキル）                     # session-planning, session-handover,
                                               # workflow-orchestrator,
                                               # requirement-analysis, maintenance-*-workflow,
                                               # agent-code-review, agent-github-pr,
                                               # agent-github-issue, cross-repository-
                                               # knowledge-link, deep-thinking, agent-kaizen

主要スキル

スキル	役割
`agentic-workflow-foundation`	基盤の設定スキル。root `manifest.yaml` の生成、tech stack 事実取り込み、`tech_contract` の承認・投影、明示承認付き Provisioning、一時 resolved skill-dir 作成、生成・監査の orchestration を担う
`agentic-workflow-engine`	生成・監査エンジン。設定スキルから渡された `manifest.yaml + templates/` を決定論的に変換する

生成先プロジェクトで利用可能になるスキル（本リポジトリでは dogfooding 済み）:

スキル	役割
`session-planning`	追跡ドキュメント（`.cursor/.tracking/tracker-{session_id}.md`）の作成・更新
`session-handover`	セッション開始/終了、handoff、検証・artifact・archive ゲート
`workflow-orchestrator`	6 段階標準タスク実行ワークフロー（①〜⑥）の制御
`requirement-analysis`	Step ①の要求正規化、3段階ガード、分析深度判定
`maintenance-docs-workflow`	起票キューから Domain 層 docs を反映する独立パイプライン
`maintenance-gotchas-workflow`	GOTCHAS の再発防止策を Meta 層へ反映する独立パイプライン
`agent-code-review`	PR レビューコメントの検証・返答
`agent-github-pr`	GitHub App wrapper 経由の PR 作成
`agent-github-issue`	GitHub App wrapper 経由の Issue 作成・読み取り
`cross-repository-knowledge-link`	登録済み関連リポジトリの docs / コード参照
`deep-thinking`	A/B 並列分析 + C 統合裁定による多角評価
`agent-kaizen`	kit 内部の manifest→生成物チェーンの整合性検査（18 評価観点）

seed default（オプション機能）

seed / root manifest.yaml では、オプション機能の seed default がすべて enabled: true です。無効化は root manifest の直接編集 → 再生成で行います（init.yaml では設定しない）。

設定キー	seed default	生成物
`code_review.enabled`	`true`	`agent-code-review`、`bin/github-pr-{reviews,comment,reply}-safe`
`github_pr.enabled`	`true`	`agent-github-pr`
`github_issue.enabled`	`true`	`agent-github-issue`、`bin/github-issue-{create,read}-safe`
`coderabbit.enabled`	`true`	`.coderabbit.yaml`
`agent_workflow.enabled`	`true`	`docs/agent-tasks/**`、`workflow-orchestrator`、`requirement-analysis`、各種 gate スクリプト
`agent_workflow.maintenance_docs.enabled`	`true`	`maintenance-docs-workflow`、`docs/agent-tasks/maintenance-docs/`
`agent_workflow.maintenance_gotchas.enabled`	`true`	`maintenance-gotchas-workflow`
`deep_thinking.enabled`	`true`	`deep-thinking`（`config.yaml` + references）
`cross_repo_knowledge.enabled`	`true`	`cross-repository-knowledge-link`、`bin/cross-repo-sync-safe`
`agent_kaizen.enabled`	`true`	`agent-kaizen`（`SKILL.md` + `config.yaml` + references）

Phase 1.68 は承認済み tech_contract.runtime_materialization.actions を扱います。materialize_runtime.py --check は read-only の renderability 検査だけを行い、file action・install・lockfile 更新は bin/project-setup --plan で提示した計画を明示承認した後の --apply だけが実行します。package.json 等はアプリ所有ファイルであり outputs[] / audit の対象外です。

生成ワークフロー

Cursor では対象プロジェクトで「Agentic 基盤を生成して」「基盤ファイルを更新して」「techstack を取り込んで再生成して」などと依頼すると、agentic-workflow-foundation が次の流れを実行します。

Phase 1: seed manifest / templates / resolver を変更する必要がある場合だけ更新する
Phase 1.45: run_resolved_engine.py bootstrap で root manifest.yaml を作成、または framework: ブロックを seed から同期する
Phase 1.5: init.yaml → apply_kit_init.py で project.name / slug / workflow_pattern（開発型固定）/ context_budget を確定する
Phase 1.55: resolve_budget_thresholds.py で min_context_window_tokens から Context Budget 閾値を算出する
Phase 1.6: init.yaml > tech_stack_design.filename で指定された設計書から tech_stack を root manifest.yaml へ取り込む
Contract lifecycle: SoT fingerprint 不一致時だけ対話 SKILL が draft を起案し、schema・安全性検証と PO 承認後に root manifest.yaml > tech_contract へ pinする
Phase 1.65: 承認済み tech_contract.quality_gate を G-* と package script contract へ投影する
Phase 1.66: tech_contract.review.coderabbit を CodeRabbit 設定へ投影する
Phase 1.67: tech_contract.domain_docs.resolved を Domain 層ドキュメント入力へ投影する
Phase 1.68: materialize_runtime.py --check で read-only 検査し、必要な書込みは明示承認付き project-setup --apply で行う
Phase 1.7: 承認済み契約の declarative preflight と実リポジトリの整合をチェックする
Phase 2: 一時 resolved skill-dir から基盤ファイル群を生成する
Phase 3: 冪等性、required sections、deep-thinking / requirement-analysis の静的契約を監査する
Phase 4: 確定値、生成物、ゲート結果を報告する

手動実行

通常は Cursor Skill 経由で実行します。手動で確認する場合は、foundation 専用ラッパーを入口にします。

# root manifest.yaml を seed から作成 / framework ブロックを同期
python3 .cursor/skills/agentic-workflow-foundation/scripts/run_resolved_engine.py bootstrap

# init.yaml → root manifest.yaml の project.* / context_budget を適用
python3 .cursor/skills/agentic-workflow-foundation/scripts/apply_kit_init.py

# Context Budget 閾値を min_context_window_tokens から導出
python3 .cursor/skills/agentic-workflow-foundation/scripts/resolve_budget_thresholds.py

# tech stack を root manifest.yaml > tech_stack へ取り込み
python3 .cursor/skills/agentic-workflow-foundation/scripts/ingest_tech_stack.py

# 承認済み tech_contract から quality gate / package script contract を投影
python3 .cursor/skills/agentic-workflow-foundation/scripts/resolve_quality_gate.py

# CodeRabbit 設定を承認済み tech_contract から投影
python3 .cursor/skills/agentic-workflow-foundation/scripts/resolve_coderabbit.py

# Domain 層ドキュメント入力を承認済み tech_contract から投影
python3 .cursor/skills/agentic-workflow-foundation/scripts/resolve_domain_docs.py

# runtime action の read-only renderability 検査
python3 .cursor/skills/agentic-workflow-foundation/scripts/materialize_runtime.py --check

# runtime / dependency 変更計画の提示と明示承認後の適用
bin/project-setup --plan
bin/project-setup --apply --plan-file <plan.json> --approve-plan <plan_digest>

# tech stack policy と実リポジトリの整合確認
python3 .cursor/skills/agentic-workflow-foundation/scripts/check_tech_stack_conformance.py

# 生成
python3 .cursor/skills/agentic-workflow-foundation/scripts/run_resolved_engine.py generate

# 冪等性ドライラン（foundation-gate 経由）
bin/foundation-gate check

# 監査（foundation-gate 経由）
bin/foundation-gate audit

# kit 全自己検証（audit + foundation script tests）
bin/foundation-gate self

# 下流プロジェクトの検証（build → lint → test）
bin/quality-gate verify

agentic-workflow-engine/scripts/generate.py と audit.py を直接呼ぶのは、エンジン単体の検証時だけです。通常の foundation 生成では run_resolved_engine.py が upstream metadata と root manifest overlay を解決してから engine を呼びます。bin/quality-gate はアプリ品質の公開入口（gen/build/lint/test/verify）、bin/foundation-gate は基盤保守の公開入口（generate/audit/check/scripts/self）です（ADR-0001）。

生成物

現行 seed manifest の outputs[] は次を管理します。

種別	ファイル
Context	`AGENTS.md`、`CLAUDE.md`
Cursor Rules	`.cursor/rules/00-init.mdc`、`01-critical-constraints.mdc`、`02-agent-conduct.mdc`
Hooks	`.cursor/hooks/guard-git-write.sh`、`session-bootstrap.sh`、`session-budget-tracker.sh`、`session-shell-tracker.sh`、`session-response-tracker.sh`、`session-compact-observer.sh`、`session-budget-evaluator.sh`、`.cursor/hooks/README.md`、`.cursor/hooks.json`
Docs (Meta)	`docs/AGENT_RUNBOOK.md`、`docs/QUALITY_GATE.md`、`docs/CONTEXT_BUDGET.md`、`docs/references/context-budget-internals.md`、`docs/DECISIONS.md`、`docs/GOTCHAS.md`
Docs (Domain)	`docs/tech-stack.md`、`docs/spec.md`、`docs/spec/README.md`、`docs/architecture.md`、`docs/api.md`、`docs/data-models.md`、`docs/coding-standards.md`、`docs/workflows.md`
Session Skills	`.cursor/skills/session-planning/SKILL.md`、`.cursor/skills/session-handover/SKILL.md`、`.cursor/skills/session-handover/scripts/verification-gate.sh`、`.cursor/skills/session-handover/scripts/session-start-gate.sh`、`.cursor/skills/session-handover/scripts/plan-gate.sh`、`.cursor/skills/session-handover/scripts/workflow-gate.sh`、`.cursor/skills/session-handover/scripts/archive-gate.sh`、`.cursor/skills/session-handover/scripts/gate-report.py`、`.cursor/skills/session-handover/scripts/gate-adr.py`、`.cursor/skills/session-handover/scripts/gate-artifact.py`、`.cursor/skills/session-handover/scripts/gate-redispatch.py`
GitHub Wrappers	`bin/_github-app-auth.sh`、`bin/github-pr-create-safe`
Optional Review	`.cursor/skills/agent-code-review/**`、`bin/github-pr-{reviews,comment,reply}-safe`、`.coderabbit.yaml`
Optional GitHub PR	`.cursor/skills/agent-github-pr/**`
Optional GitHub Issue	`.cursor/skills/agent-github-issue/**`、`bin/github-issue-{create,read}-safe`
Optional Agent Workflow	`docs/agent-tasks/agent-workflow/`、`docs/agent-tasks/README.md`、`docs/agent-tasks/{reports,maintenance-docs}/`、`.cursor/skills/workflow-orchestrator/`、`.cursor/skills/requirement-analysis/`、任意の `.cursor/skills/maintenance-{docs,gotchas}-workflow/`
Optional Deep Thinking	`.cursor/skills/deep-thinking/SKILL.md`、`.cursor/skills/deep-thinking/config.yaml`、`.cursor/skills/deep-thinking/README.md`、`.cursor/skills/deep-thinking/references/**`
Optional Cross-Repo	`.cursor/skills/cross-repository-knowledge-link/**`、`bin/cross-repo-sync-safe`
Optional Agent Kaizen	`.cursor/skills/agent-kaizen/SKILL.md`、`.cursor/skills/agent-kaizen/config.yaml`、`.cursor/skills/agent-kaizen/references/**`
Ignore Blocks	`.gitignore`、`.cursorignore`

各オプション出力の条件:

.cursor/skills/agent-code-review/** と bin/github-pr-{reviews,comment,reply}-safe — code_review.enabled: true の場合のみ
.cursor/skills/agent-github-pr/** — github_pr.enabled: true の場合のみ
.cursor/skills/agent-github-issue/** と bin/github-issue-{create,read}-safe — github_issue.enabled: true の場合のみ
.coderabbit.yaml — coderabbit.enabled: true の場合のみ
docs/agent-tasks/agent-workflow/**、docs/agent-tasks/reports/、.cursor/skills/workflow-orchestrator/**、各種 workflow gate スクリプト — agent_workflow.enabled: true の場合のみ
.cursor/skills/requirement-analysis/** — agent_workflow.enabled: true の場合
.cursor/skills/maintenance-docs-workflow/** — agent_workflow.maintenance_docs.enabled: true の場合のみ
.cursor/skills/maintenance-gotchas-workflow/** — agent_workflow.maintenance_gotchas.enabled: true の場合のみ
.cursor/skills/deep-thinking/** — deep_thinking.enabled: true の場合のみ
.cursor/skills/cross-repository-knowledge-link/** と bin/cross-repo-sync-safe — cross_repo_knowledge.enabled: true の場合のみ
.cursor/skills/agent-kaizen/** — agent_kaizen.enabled: true の場合のみ

Domain 層ドキュメント（docs/spec.md 等）は seed モードで初回のみ生成し、以降は PO が内容を充実させます。

5層モデル

このキットは AI エージェント運用を 5 層で整理します。

Layer	役割	本キットでの表現
1. Context	目的・判断基準・運用入口	`AGENTS.md`、`CLAUDE.md`、`docs/*`
2. Constraints	常時適用される制約	`.cursor/rules/*.mdc`
3. Capabilities	必要時に呼び出す専門手順	`session-`、`workflow-orchestrator`、`requirement-analysis`、`maintenance--workflow`、GitHub 連携、`cross-repository-knowledge-link`、`deep-thinking`、`agent-kaizen`
4. Automation	ツール実行前後・セッション境界の自動処理	`.cursor/hooks/*`、`.cursor/hooks.json`
5. Delegation	子エージェントへの委譲	本キットでは生成しない。Cursor 組み込み Subagent を利用する

Meta 層 / Domain 層はドキュメント命名上の 2 層モデルです。Layer 1〜5 は運用アーキテクチャ上の分類で、別軸として扱います。

設計原則

生成物を直接編集しない

AGENTS.md、Rules、Hooks、生成 docs、生成スキル、bin/ wrapper は出力です。変更は upstream docs、seed manifest.yaml、templates/、resolver scripts、または root manifest.yaml の project 値を更新して再生成します。直接編集は audit が drift として検出します。

root manifest の責務を分ける

root manifest.yaml は対象プロジェクトの正式 project manifest です。ただし framework: ブロックの SoT は seed manifest で、root 側は同期された複製です。framework.budget_thresholds は Phase 1.55 の resolve_budget_thresholds.py が project.context_budget.min_context_window_tokens から算出して上書きします。outputs / quality_gate_contract は root に保持せず seed / 承認済み tech_contract から一時展開します。tech_contract は手編集せず、対話 SKILL の draft → validate → PO 承認 → apply で pin します。

upstream docs は immutable input

AI_AGENT_UNIFIED_DESIGN.md と AI_BUSINESS_AGENT_SUITE.md は読み取り専用の upstream SoT です。run_resolved_engine.py が存在有無と fingerprint を resolved manifest に反映しますが、スキル実行で書き換えません。

tech stack は project input

技術スタック統一設計書はプロジェクトごとに変わる技術入力です。ファイル名は init.yaml > tech_stack_design.filename で必須指定し、配置は .cursor/docs/ 固定です。ingest_tech_stack.py が事実表を tech_stack へ取り込み、docs/tech-stack.md の Domain サマリに使います。G-* / runtime / CodeRabbit / Domain docs / Provisioning は、設計書から対話 SKILL が起案し承認後に pin した tech_contract だけを入力にします。

Context Budget は Hook で観測する

生成される Hooks は、危険な Git 操作のガードと長時間セッションの引き継ぎ促進を担います。prompt_count、shell_bytes、compact イベントを proxy 指標として Yellow / Red を判定し、必要に応じて handoff manifest（.cursor/.session/handoff-{session_id}.md）を使った新規チャット移行を促します。技術詳細は docs/CONTEXT_BUDGET.md と .cursor/hooks/README.md を参照。

前提条件

Python 3（生成・監査エンジンは標準ライブラリのみ）
PyYAML（agent_workflow.enabled: true で step artifact ゲートを使う場合）
git
jq（Hook 実行時を推奨。未インストール時は fail-open）
gh（GitHub 連携スキル使用時を推奨）
.cursor/docs/ 配下の技術スタック統一設計書（ファイル名は init.yaml > tech_stack_design.filename で指定）
Optional: CodeRabbit / GitHub review 運用を使う場合は、対象プロジェクト側の GitHub / CodeRabbit 設定

macOS では make install / make check で CLI 依存を一括確認できます。

外部サービス・Cursor 設定を含む詳細なセットアップ手順は setup.md を参照。

このリポジトリと生成先

本リポジトリはジェネレータ・ツールキット本体です。対象プロジェクトにこのキットの .cursor/skills/agentic-workflow-foundation と .cursor/skills/agentic-workflow-engine を配置し、Cursor から agentic-workflow-foundation を起動すると、対象プロジェクトのルートに基盤ファイル群が生成されます。

本リポジトリ自身も dogfooding 対象のため、ルート直下に manifest.yaml と生成物が存在します。キット開発時は seed manifest / templates を変更し、再生成 + audit で整合を保ちます。

詳細な運用手順は agentic-workflow-foundation/SKILL.md、エンジン仕様は agentic-workflow-engine/SKILL.md を参照してください。

ライセンス

Apache License 2.0

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Agentic Workflow Foundation Kit

できること

現行アーキテクチャ

リポジトリ構成

主要スキル

seed default（オプション機能）

生成ワークフロー

手動実行

生成物

5層モデル

設計原則

生成物を直接編集しない

root manifest の責務を分ける

upstream docs は immutable input

tech stack は project input

Context Budget は Hook で観測する

前提条件

このリポジトリと生成先

ライセンス

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 58 Commits
.cursor		.cursor
.coderabbit.yaml		.coderabbit.yaml
.cursorignore		.cursorignore
.gitignore		.gitignore
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
init.yaml		init.yaml
setup.md		setup.md

Folders and files

Latest commit

History

Repository files navigation

Agentic Workflow Foundation Kit

できること

現行アーキテクチャ

リポジトリ構成

主要スキル

seed default（オプション機能）

生成ワークフロー

手動実行

生成物

5層モデル

設計原則

生成物を直接編集しない

root manifest の責務を分ける

upstream docs は immutable input

tech stack は project input

Context Budget は Hook で観測する

前提条件

このリポジトリと生成先

ライセンス

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages