work-logs-knowledge-log
ナレッジログを出力する
When & Why to Use This Skill
This Claude skill automates the creation of structured knowledge logs to capture repository architectures, implicit rules, and design intentions. It specifically focuses on bridging the gap between an AI's code inference and the user's actual project context, ensuring that critical business logic, operational constraints, and 'hidden' rules are documented in markdown format for long-term project maintenance.
Use Cases
- Documenting implicit architectural decisions and design patterns that are not explicitly visible in the source code.
- Recording the 'delta' or gap between AI-generated assumptions and the actual project requirements to prevent recurring misunderstandings.
- Capturing business logic prerequisites and operational constraints that govern how specific modules should be handled.
- Maintaining a living repository of 'implicit rules' and conventions to streamline onboarding for new developers or AI agents.
- Automating the generation of timestamped knowledge snapshots to track the evolution of project rules and structural changes.
| name | work-logs-knowledge-log |
|---|---|
| description | ナレッジログを出力する |
| allowed-tools | Read, Write, Grep, Glob |
ナレッジ書き出し
ユーザーの求めに応じて対話セッション中で新しく認識したリポジトリの構造やルールについて書き出してください。
書き出し先は ~/.claude/knowledge/${repo_name}/${date time prefix}_$description.md とします。
date time prefix は以下のようにしてください。
- date コマンドを利用してログ出力処理時の現在時刻を取得する
- フォーマットは
+%Y-%m-%d_%H-%Mとする
- フォーマットは
- タイムゾーンはAsia/Tokyoとする
記録すべき内容
AIがソースコードから推測した内容とユーザーの実際の認識のギャップが発生した場合、それを優先的に記録する。
具体的には:
- プロジェクトの設計思想や意図でソースコードからは読み取れないもの
- コード構造の背景にある理由
- 運用上の制約や慣習
- ビジネスロジックの前提条件
- 暗黙のルールや例外的な扱い
記録の意義
これらのギャップはソースコードからの認知が困難な箇所を示しており、ドキュメント整備が必要な箇所の特定に繋がる。