| name | context |
| description | Reqordのデータモデル（Requirement, Specification, ProjectContext, Feedback）とCLI操作ルールの共通知識ベース。 |
| user-invokable | false |
| allowed-tools | Read, Glob, Bash(reqord:context *), Bash(reqord:req list *), Bash(reqord:spec list *) |
| model | sonnet |
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 / lowsuccessCriteria: 成功基準のリスト（検証可能な条件）format: user-story（as/iWant/soThat）または EARSdependencies: blockedBy / blocks / relatedToestimatedComplexity: small / medium / largeversion: セマンティックバージョン（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-idtitle: 仕様タイトル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でヒアリングを行うスキル実装時 |
