work-logs-knowledge-log

ナレッジログを出力する

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026⬇️2downloads

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.
namework-logs-knowledge-log
descriptionナレッジログを出力する
allowed-toolsRead, Write, Grep, Glob

ナレッジ書き出し

ユーザーの求めに応じて対話セッション中で新しく認識したリポジトリの構造やルールについて書き出してください。 書き出し先は ~/.claude/knowledge/${repo_name}/${date time prefix}_$description.md とします。

date time prefix は以下のようにしてください。

  • date コマンドを利用してログ出力処理時の現在時刻を取得する
    • フォーマットは +%Y-%m-%d_%H-%M とする
  • タイムゾーンはAsia/Tokyoとする

記録すべき内容

AIがソースコードから推測した内容とユーザーの実際の認識のギャップが発生した場合、それを優先的に記録する。

具体的には:

  • プロジェクトの設計思想や意図でソースコードからは読み取れないもの
  • コード構造の背景にある理由
  • 運用上の制約や慣習
  • ビジネスロジックの前提条件
  • 暗黙のルールや例外的な扱い

記録の意義

これらのギャップはソースコードからの認知が困難な箇所を示しており、ドキュメント整備が必要な箇所の特定に繋がる。