What is an AI-DEV-NOTE?

An AI-DEV-NOTE is a specialized comment format used to communicate implementation rationale, subtle bugs, or alternative approaches directly to future AI assistants and developers.

How does this skill improve technical debt management?

It introduces a structured TODO format that includes categories (like performance or security), impact analysis, and estimated effort, making technical debt easier to audit and prioritize.

Does this skill support architectural decision tracking?

Yes, it includes a Decision Record format to document significant choices, rationales, and alternatives considered, serving as an inline Architectural Decision Record (ADR).

When should I use uncertainty markers?

Use uncertainty markers whenever the AI assistant performs a task that involves potential edge cases, such as timezone handling or concurrency, to flag the code for manual human review.

Is this skill compatible with all programming languages?

Yes, the patterns are designed to work within standard comment syntaxes across all major languages including TypeScript, Python, Go, Rust, and Java.

AI Note-Taking Fundamentals

Name: AI Note-Taking Fundamentals
Author: TheBushidoCollective

byTheBushidoCollective

•

Productivity & Workflow

Establishes standardized code annotation patterns to preserve context for AI assistants and human developers during software development.

This skill provides a comprehensive framework for leaving meaningful breadcrumbs in codebases through structured documentation patterns. It introduces specialized formats like AI-DEV-NOTE and categorized TODOs to bridge the gap between AI and human understanding, ensuring that the rationale behind complex decisions is never lost. By documenting implementation 'whys', signaling uncertainty in sensitive code paths, and recording architectural trade-offs, this skill helps teams maintain a high-context environment that facilitates safer refactoring and more ethical software evolution.

Key Features

01Structured TODO formats with impact, effort, and dependency tracking

02Specialized AI-to-AI communication notes for preserving implementation rationale

03Inline Decision Records for documenting architectural trade-offs and alternatives

04Context preservation markers for platform-specific workarounds and legacy logic

0572 GitHub stars

06Uncertainty signaling for areas requiring human expert review

Use Cases

01Managing technical debt with categorized, searchable, and prioritized TODO comments

02Documenting complex business logic to prevent future AI-generated regressions

03Recording historical context for non-obvious code patterns to aid future developer onboarding

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