specsfy-monorepo-documentator

Specsfy モノレポを文書化する

1. ルートで実行します：

python3 -B \
  .agents/skills/specsfy-monorepo-documentator/scripts/collect_monorepo_evidence.py \
  --workspace .

1. コレクターから、ディレクトリが公式モノレポを表していないと報告された場合は中止します。
2. ルートの AGENTS.md と、影響を受けるモジュールの指示をすべて読みます。
3. docs/develop/context/README.md と、変更によって指定されたコンテキストのみを読みます。
4. トポロジー、分類、閲覧順序を編集する前に、文書化の標準を読みます。
5. 各記述を、担当モジュールのコード、テスト、マニフェスト、設定、スキーマ、運用文書または規範コンテキストと照合します。
6. 変更がアーキテクチャと使い方の両方に及ぶ場合は、両方の文書を更新します：
   • docs/user/ のユーザー向け文書。
   • docs/develop/ の技術文書。 docs/user/installation.md を正式なインストールガイドとして維持し、基本スキルごとに docs/user/skills/ にページを用意します。docs/user/reading-order.txt の学習順序は一貫性を保ち、メソッド、インストール、初回の成果物、基本フロー、運用、高度な使い方の順にします。
7. モジュール間では相対リンクを使用します。公開 URL には https://github.com/promovaweb/specsfy を使用します。
8. docs/user/ を変更した後は、必ずバージョン管理に追加し、make ebook で PDF、EPUB、マニフェストを再生成します。
9. 各モジュールの焦点を絞ったテストと統合回帰テストを実行し、モノレポ全体で単一のステータスと差分を確認します。

エビデンスに関するポリシー

• 現在の情報源で確認できる内容のみを事実として記録します。
• 現行の決定、実装済みの状態、推論、未解決事項を区別します。
• 情報源に食い違いがある場合は、確認された状態をそのまま維持します。
• マニフェスト、ルート、スキーマ、テストから導き出した大量の一覧を複製しません。
• 目的がない限り、シークレット、本番データ、内部コンテンツを複製しません。
• ルートに plan.md、tasks.md、research.md、data-model.md、specs/ を作成しません。

利用者向けドキュメント作成ツールとの境界

このスキルでは、モノレポの方法論、アーキテクチャ、公式ガイドを文書化します。利用者アプリケーションの <projeto>/docs/ については、$specsfy-documentator を読み込みます。

ローカルでの排他性

• ソースは .agents/skills/specsfy-monorepo-documentator/ のみに置きます。
• シンボリックリンク .claude/skills/specsfy-monorepo-documentator を使って、Claude に同じソースを公開します。
• skills/ に同名のスキルを作成したり、インストーラーに含めたりしません。
• 監査のみを求められた場合は、情報を収集して読むだけにとどめ、ファイルを公開しません。