Scope

• Do: 他スキルが参照する共通データモデル・CLI操作ルール・リファレンス提供
• Don't: 直接トリガーされることは想定しない（user-invokable: false）。データの変更操作は各専用スキルで実施

---

Reqord共通知識ベース

このスキルは全reqord系スキル・エージェントの共通基盤。データモデルとCLIルールを定義する。

---

1. データモデル

Requirement（要件）

• ID形式: req-NNNNNN（6桁ゼロ埋め）
• ステータスライフサイクル: draft → approved → implemented → deprecated
  • deprecated への遷移はCLIコマンドで直接実行する。遷移前に必ず /reqord:verify trace <req-id> で影響範囲を確認し、関連specへの影響を把握してからdeprecateすること
• 主要フィールド:
  • title: 要件タイトル
  • status: 現在のステータス
  • priority: high / medium / low
  • successCriteria: 成功基準のリスト（検証可能な条件）
  • format: user-story（as/iWant/soThat）または EARS
  • dependencies: blockedBy / blocks / relatedTo
  • estimatedComplexity: small / medium / large
  • version: セマンティックバージョン（X.Y形式）
  • versionHistory: バージョン履歴配列（version, status, gitCommit, approvedAt, approvedBy）
  • flags: feedback-review 等のフラグ配列
• ファイル構成:
  • .reqord/requirements/<req-id>.yaml - メタデータ
  • .reqord/requirements/<req-id>/description.md - 詳細記述

Specification（仕様）

• ID形式: spec-NNNNNN（6桁ゼロ埋め）
• ステータスライフサイクル: draft → approved → implemented
  • Specificationにdeprecatedステータスはない。紐づくRequirementがdeprecatedになった場合、関連Specificationは実質的に無効となる
• 主要フィールド:
  • requirementId: 紐づくreq-id
  • title: 仕様タイトル
  • status: 現在のステータス
  • version: セマンティックバージョン（X.Y形式）
  • versionHistory: バージョン履歴配列
  • flags: フラグ配列
• ファイル構成:
  • .reqord/specifications/<spec-id>.yaml - メタデータ
  • .reqord/specifications/<spec-id>/design.md - 技術設計書

ProjectContext（プロジェクトコンテキスト）

• 構成ファイル:
  • .reqord/context/context.yaml - メイン設定（files参照を含む）
  • product.yaml - プロダクトビジョン・スコープ
  • technical.yaml - 技術スタック・アーキテクチャ
  • structure.yaml - コード構造・命名規則
  • domain/*.md - ドメイン固有知識

Feedback（フィードバック）

• ファイル: .reqord/issues/feedbacks.yaml
• GitHub Issueと同期。type（bug/improvement/requirement-gap/spec-mismatch/security）、severity、linkedTo で分類
• reqord feedback sync でGitHub Issueから取り込み

Tasks（タスク）

• ファイル: .reqord/issues/tasks.yaml
• Specificationに紐づくGitHub Issueのタスク管理
• reqord task sync でGitHub Issueから同期

---

2. YAML直接編集禁止ルール

.reqord/ 配下のYAMLファイルは原則として直接編集してはならない。必ず reqord CLIコマンドを経由すること。

CLIコマンドはバリデーション・バージョン管理・監査証跡を自動で処理する。直接編集はこれらを迂回し、データ不整合の原因となる。

操作→CLIコマンド対応表

操作	CLIコマンド	直接編集
ステータス変更	reqord req approve/draft/implement	禁止
バージョンバンプ	reqord version <id> --patch|--major	禁止
フィールド更新（SC等）	reqord req update --patch-file	禁止
description.md更新	reqord req update --description-file	禁止
フラグ除去	reqord feedback resolve <id> --issue <N>	禁止
フィードバック操作	reqord feedback link/unlink/close/resolve	禁止
Issue同期	reqord task sync/sync-all	禁止
design.md書き込み	Writeツールで直接書き込み	許可（CLIコマンドなし）
plugin-config.yaml書き込み	Writeツールで直接書き込み	許可（プラグイン固有設定、/reqord:setup のみ）

design.mdが直接書き込み可能な理由: design.mdはCLIバリデーション対象外の自由記述ファイルであり、対応するCLIコマンドが存在しない。一方、description.mdは reqord req update --description-file 経由で更新すること（バリデーション・バージョン管理が適用されるため）。

| コンテキスト更新 | reqord context update | 禁止 |

バージョン管理ルール

内容を変更したらバージョンを上げる。

• --patch（X.Y+1）: 内容の修正・改善・追記
• --major（X+1.0）: 破壊的変更・大幅な構造変更
• コマンド: reqord version <id> --patch --summary "<変更概要>"

---

3. 提供スキル一覧

スキル	用途
/reqord:setup	環境セットアップ・前提条件チェック
/reqord:status	要件・仕様の実装進捗ダッシュボード
/reqord:new	req/specの新規作成
/reqord:edit	req/spec/contextの編集・改善
/reqord:brief	spec/req/issueの包括的コンテキスト表示
/reqord:verify	実装検証・ステータス更新
/reqord:feedback	フィードバック・バグ報告の処理
/reqord:context	このスキル。データモデル・CLI・共通知識

プロジェクトのプロセスに応じて、これらを自由に組み合わせて使用する。

---

4. リファレンス（resources/）

詳細な知見は resources/ ディレクトリを参照。必要に応じて読み込むこと。

ファイル	内容	読むタイミング
resources/cli-reference.md	CLIコマンド全集・データ読み込み手順	CLIコマンドの引数やオプションを確認する時
resources/philosophy.md	設計思想・5原則	設計判断時、ツールの位置づけを説明する時
resources/quality-framework.md	SMART + EARS + 粒度ルール	要件作成・詳細化・バリデーション時
resources/traceability.md	三層モデル・依存関係・フラグ	影響分析、依存関係設定、フラグ運用時
resources/feedback-workflow.md	フィードバック3段階進化	フィードバック処理・リンク時
resources/ai-phases.md	AI支援4フェーズ・HitL境界	AI詳細化・設計生成・タスク分解時
resources/anti-patterns.md	アンチパターン・チェックリスト	レビュー時、品質確認時
resources/git-conventions.md	ブランチ命名・コミット・PRテンプレート	ブランチ作成・コミット・PR作成時（/reqord:brief のGit操作ガイドから参照）
resources/task-workflow.md	タスク定義形式・HTMLタグ・CLIコマンド	reqord task create を直接CLI実行する時（専用スキルなし、直接参照）
resources/dialogue-guidelines.md	対話設計の原則・テンプレート・アンチパターン	AskUserQuestionでヒアリングを行うスキル実装時