skills.rest
ryan-mahoney
ryan-mahoneyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

architect-initial

Assess proposed changes against existing software architecture and produce an implementation plan or incompatibility assessment.

Updated Mar 14, 2026
Search Tags:#architecture#codebase#compatibility#system-design#design-review#refactor-planning
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill architect-initial
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architect-initial
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/architect-initial
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill architect-initial

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Assess proposed changes against the current software architecture and deliver either a compatible implementation plan that fits the existing system or a clear incompatibility assessment with recommended alternatives.

Core Features & Use Cases

  • Produce Compatible Proposal: generate a concrete plan that integrates with established modules and conventions.
  • Incompatibility Assessment: explain why a request cannot be implemented within the current architecture and outline feasible refactors or alternatives.
  • Architecture Context Utilization: leverage existing docs or patterns (e.g., AGENTS.md, project conventions) to ground the assessment and provide actionable next steps.

Quick Start

Provide a problem statement with the current architecture context and I will return a concrete, step-by-step implementation plan or a rationale for incompatibility.

Frequently Asked Questions about architect-initial

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a new feature fits my existing software architecture?▼

To assess architecture compatibility, provide a problem statement with your repository context to generate a concrete implementation plan that integrates with established modules or a clear incompatibility assessment.

What is an architecture compatibility assessment and when do I need one?▼

An architecture compatibility assessment evaluates proposed changes against current system patterns and constraints to determine if a feature can be implemented without disruptive refactors or new infrastructure.

How do I plan a codebase refactor for a feature that is incompatible with current system design?▼

When a proposed change is incompatible, the assessment outlines feasible refactors or alternatives, specifying exact components, data flow modifications, and refactor requirements needed to support the request.

Can I use project conventions like AGENTS.md to ground an implementation plan?▼

Yes, architecture context utilization leverages existing docs like AGENTS.md and project conventions to ground the assessment, ensuring the generated implementation plan matches your established patterns.

What are the limitations of evaluating system design compatibility within an existing codebase?▼

This approach avoids recommending disruptive changes or new infrastructure unless fully justified, meaning it prioritizes fitting within current architectural constraints over proposing complete system overhauls.

Related Skills

Explore More Software Engineering Skills→
strativdstrativd
9

Add AGENTS.md Within Directory

Analyze a repository to generate a tailored AGENTS.md with conventions and guardrails.

Community
Advanced
ZeliperZeliper

spawn-coder

Delegate coding tasks to a coder-agent via the Task tool.

Community
Intermediate
lasswelltlasswellt
1

codebase-map

Analyze a codebase across technology, architecture, quality, and concerns to generate CODEBASE-MAP.md.

Community
Advanced
arbazkhan971arbazkhan971
26

predict

Assess code or feature specifications with multi-persona risk verdicts and voting gates.

Community
Advanced