Does this work with any programming language?

Yes, the note-taking patterns are designed to be language-agnostic and provide specific examples for TypeScript, Python, Go, and Rust.

Why should I use uncertainty markers?

Uncertainty markers allow the AI to signal when a solution might need manual verification, particularly in high-stakes areas like security, concurrency, or complex timezone logic.

What is an AI-DEV-NOTE?

An AI-DEV-NOTE is a specialized comment format designed for AI-to-AI communication, explaining non-obvious logic and implementation decisions to future AI assistants or human reviewers.

How does this skill help with technical debt?

It implements structured TODOs that include categories like refactor or performance, impact assessments, effort estimates, and specific blockers, making debt easier to track and prioritize.

AI Note-Taking & Documentation

Name: AI Note-Taking & Documentation
Author: TheBushidoCollective

byTheBushidoCollective

•

Learning & Documentation

Implements structured note-taking patterns and AI-specific annotations to preserve context and development rationale within codebases.

Note-Taking Fundamentals provides a standardized framework for Claude to leave high-context breadcrumbs during the development process. By using specialized formats like AI-DEV-NOTES, structured TODOs, and decision records, this skill ensures that the reasoning behind implementation choices is preserved. It facilitates seamless collaboration between human developers and future AI sessions by signaling uncertainty, documenting trade-offs, and linking code directly to external context like PRs, issues, and documentation.

Key Features

0197 GitHub stars

02Inline decision records to document architectural trade-offs

03Uncertainty markers to highlight code requiring human expert review

04Structured TODO patterns including priority, effort, and blockers

05Standardized AI-DEV-NOTE format for AI-to-AI context sharing

06Context preservation rules for linking code to external documentation

Use Cases

01Tracking technical debt with categorized TODOs and concrete next steps

02Documenting non-obvious workarounds for browser-specific bugs or legacy API constraints

03Providing clear rationale for performance-related refactoring and architectural choices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han note-taking-fundamentals

For use in Claude.ai and ChatGPT

Download Skill