annotate-inline

Annotate Project

You are tasked with generating CLAUDE.md files across a brownfield project. You will map the project structure, auto-detect its architecture, analyze each architectural layer, and batch-write compact CLAUDE.md files at the root and relevant subdirectories.

Initial Setup:

Use the current working directory as the target project by default. If the user provides a specific directory path as an argument, use that instead.

Steps to follow:

1. Read any directly mentioned files first:

   • If the user mentions specific files (existing CLAUDE.md, architecture docs, READMEs), read them FULLY first
   • IMPORTANT: Use the Read tool WITHOUT limit/offset parameters to read entire files
   • CRITICAL: Read these files yourself in the main context before invoking any skills
   • This ensures you have full context before decomposing the work

2. Pass 1 — Map the project (parallel agents):

   • Spawn the following agents in parallel using the Agent tool:

   Agent A — Project tree mapping:

   • subagent_type: codebase-locator
   • Prompt: "Map the full project tree structure for [target directory]. List all directories and their contents, respecting .gitignore. Focus on source code directories, configuration files, and build artifacts. Return a complete tree view."

   Agent B — Architecture and conventions:

   • subagent_type: codebase-locator
   • Prompt: "Identify the architectural layers, folder roles, and framework conventions in [target directory]. Determine: What architecture pattern is used (clean architecture, MVC, monorepo, microservices, hexagonal, etc.)? What are the main layers/modules? What frameworks and languages are present? What build system is used? For each main layer/module, check if it contains internal sub-layers with distinct architectural roles. If it does, explicitly flag each sub-layer as a CLAUDE.md target candidate with: (a) path, (b) role/responsibility, (c) approximate file count, (d) how its patterns differ from siblings. Frontend frameworks (Angular, React, Vue, etc.) almost always have distinct sub-layers — components, services, shared/base classes, state management — report each separately."