init_ai_readme
Scan a project for missing or empty AI_README files, create a root-level AI_README when none exists, and generate directory-specific prompts to document tech stack, patterns, and naming conventions.
Instructions
Initialize and populate empty AI_README files within a project. When to use:
First-time setup when no AI_README exists.
get_context_for_file reports empty or missing AI_README files.
Newly created directories need conventions recorded.
Multiple directories require conventions in one pass. What it does:
Scans for missing or empty AI_README documents.
Creates a root-level AI_README if none is present.
Provides directory-specific prompts to gather conventions.
Guides you through documenting tech stack, patterns, and naming. Workflow:
Call init_ai_readme.
Follow the step-by-step instructions to inspect each directory.
Use update_ai_readme to record the conventions.
Run validate_ai_readmes to check for problems.
Fix any warnings (remove redundant content, add Cross-directory dependencies section).
Re-run get_context_for_file to confirm coverage before coding.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectRoot": "<projectRoot>"
},
"name": "init_ai_readme"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| targetPath | No | Specific directory to initialize (optional, defaults to scanning entire project) | |
| projectRoot | Yes | The root directory of the project. Use the current working directory (e.g., from environment or pwd). If unsure, pass the project root path. | |
| excludePatterns | No | Glob patterns to exclude when scanning |