Problem Statement
Improve the system prompt used to generate CLAUDE.md and introduce a dedicated prompt-loading approach so we can manage multiple LLM system prompts cleanly as the project grows.
Proposed Solution
- Refine the generator prompt for clearer instructions, constraints, and quality checks.
- Content is now maintained in
prompts/claude_md_generator.md instead of an inline Python string.
Prompt loading arrangement
- Add
src/agentready/prompts/ package with a load_prompt(name) utility (reads .md files via importlib.resources).
- Move the CLAUDE.md generator prompt into
prompts/claude_md_generator.md and wire the fixer to use load_prompt("claude_md_generator").
- Build the Claude CLI command with safe shell quoting (
shlex.quote) instead of f-string interpolation.
- Remove the old inline prompt and commented-out block from
fixers/documentation.py.
- Include
prompts/*.md in package data so prompts are shipped with the package.
Alternatives Considered
A clear and concise description of any alternative solutions or features you've considered.
Acceptance Criteria
Priority
How important is this feature to you?
Problem Statement
Improve the system prompt used to generate CLAUDE.md and introduce a dedicated prompt-loading approach so we can manage multiple LLM system prompts cleanly as the project grows.
Proposed Solution
prompts/claude_md_generator.mdinstead of an inline Python string.Prompt loading arrangement
src/agentready/prompts/package with aload_prompt(name)utility (reads.mdfiles viaimportlib.resources).prompts/claude_md_generator.mdand wire the fixer to useload_prompt("claude_md_generator").shlex.quote) instead of f-string interpolation.fixers/documentation.py.prompts/*.mdin package data so prompts are shipped with the package.Alternatives Considered
A clear and concise description of any alternative solutions or features you've considered.
Acceptance Criteria
Priority
How important is this feature to you?