Neura Market
prompt logo

prompt

Free

AI prompt for codebase-driven implementation planning

FreeFree tier
Type
Open Source
Visit Website GitHub (40 stars)

About prompt

This prompt, authored independently and hosted in the ai-boost/awesome-prompts GitHub repository (8.5k stars), defines a system prompt for a 'Solution Architect Agent'. The agent's role is to thoroughly study a codebase before writing any code and produce a concrete, well-reasoned implementation plan. The prompt instructs the agent to explore the codebase, understand conventions, identify affected files, present at least two implementation options with trade-offs, recommend one, break the plan into ordered steps, and call out risks and open questions. It emphasizes grounding recommendations in actual codebase observations, favoring reversible incremental changes, and avoiding over-engineering. The prompt is intended for use with AI coding assistants like Claude and originated from the repowise-dev/claude-code-prompts repository.

Key Features

Requires thorough codebase exploration before proposing changes
Identifies all files, modules, and dependencies affected by a change
Presents at least two distinct implementation options with detailed trade-offs
Recommends one approach with specific justification tied to codebase context
Breaks the recommended approach into ordered implementation steps with file paths
Calls out open questions, unknowns, and decisions needing human input
Grounded in actual codebase observations; no assumed conventions

Pros & Cons

Pros
  • Forces deep codebase understanding before acting, reducing mistakes
  • Encourages evaluation of multiple approaches, leading to better decisions
  • Emphasizes reversible, incremental changes over risky rewrites
  • Explicitly surfaces uncertainties rather than glossing over them
  • Produces a concrete, actionable plan that can be reviewed or executed step by step
Cons
  • Requires full access to the codebase and ability to read all relevant files, which may be time-consuming
  • May produce overly detailed plans for trivial changes
  • Depends on the AI model's ability to accurately interpret codebase conventions and dependencies
  • The generated plan may become outdated quickly if the codebase changes during planning

Best For

Planning feature implementations in existing codebasesRefactoring large codebases with minimal riskOnboarding new contributors by providing structured implementation guidesEvaluating architectural alternatives before committing to a designGenerating comprehensive change plans for code review preparation

FAQ

What is the purpose of the Solution Architect Agent prompt?
It instructs an AI to study a codebase thoroughly and produce a concrete implementation plan before any code is written, ensuring well-reasoned changes.
How does the prompt ensure high-quality plans?
It requires exploring existing documentation, mapping affected files, presenting multiple options with trade-offs, recommending one with justification, and breaking into ordered steps with risk awareness.
Is this prompt tied to a specific AI tool?
The prompt originated from the repowise-dev/claude-code-prompts repository (intended for Claude) but is hosted in the general awesome-prompts collection and can be used with any compatible AI.