forge

FORGE

FORGE は、範囲を限定した作業のための明示的なワークフローです。1 つのタスク、明確な範囲、厳格な停止条件、エビデンス、そして明確なチェックポイントを定めます。

ガバナンスに基づく実装、計画、レビュー、リリース、調整、またはコンテキストを安全に保つための初期化に使用します。

ルーティング

• ドキュメントを初期化または移行する：forge-bootstrap
• ライフサイクルの作業を計画する：forge-plan
• タスクを構築・実装する：forge-build または forge-execute-task
• 作業をレビューする：forge-review
• リリース、公開、または完了処理を行う：forge-ship
• 範囲と前提を批評する：forge-critique
• セキュリティレビューを実施する：forge-security-review
• 完了状況とエビデンスを確認する：forge-evaluation
• 教訓を読み込む／更新する：forge-memory
• 非公開／公開ツールのリリースを管理する：forge-tool-workflow
• 複数リポジトリにまたがる共有契約の作業を調整する：forge-cross-project

現在のタスクで必要な場合にのみ、参照資料を読み込みます。

• チームとブランチ：references/team-mode.md
• リポジトリの種類：references/repo-flavors.md
• エージェントの種類：references/agent-flavors.md
• DevSecOps のゲート：references/devsecops-gates.md
• アプリのドキュメント：references/application-docs.md
• ライフサイクルマップ：references/lifecycle-map.md
• スキルの構成：references/skill-anatomy.md
• コンテキストとトークンの運用規律：references/token-efficiency.md

運用モデル

1. 現在のステップに必要な最小限のプロジェクト固有のコンテキストを読み込みます。
2. docs/forge/CONTEXT.md が存在する場合は優先して使用し、存在しない場合は保守的な lite のデフォルト設定を使用します。
3. docs/forge/AI.md、簡潔なタスクインデックスまたは設定済みのタスクソース、選択したタスクを 1 つ、およびタスクに関連するソースファイルを読み込みます。
4. 起動時に FORGE のドキュメント、すべてのタスク、すべてのメモリ、またはすべてのセキュリティチェックリストを読み込まないでください。
5. 実装、エビデンス、タスクの状態、コミットまたは PR/MR の引き継ぎを含む、範囲を限定したチェックポイントを一度に 1 つだけ維持します。
6. 曖昧さ、前提条件の不足、アーキテクチャの競合、安全でない操作、未解決のセキュリティ懸念、またはゲートの失敗がある場合は停止します。
7. アクティベーションは activation_mode に従います。リポジトリのデフォルトルーティングには、その利用への同意が必要です。

チームモード

複数の開発者またはエージェントが並行して作業する場合：

• 共有ブランチで直接作業するのではなく、フィーチャーブランチを使用します
• 実装前にタスクを 1 つ割り当てます
• 実行可能なタスクには明示的な file_scope を必須とします
• GitHub または GitLab が正式な管理元である場合は、イシューの割り当てとラベルを優先します
• 可能な限り、追記のみのエビデンス記録とメモリ記録を使用します
• CI と保護されたブランチでのマージを必須とします

出力の運用規律

docs/forge/AI.md の progress_policy に従います（指定がない場合のデフォルトは compact です）。 簡潔なチェックポイント出力、詳細なブロッカー、最後に 1 つの要約を出力します。タスクファイルとコミットにすでに記録されている内容をタスクごとに繰り返し要約することはありません。プロトコル全体については、references/checkpoint-output.md を参照してください。