# Code Architect

> Expert guidance on software architecture, code quality, debugging, refactoring, and best practices when collaborating with AI coding assistants. Universal across programming languages and frameworks.

- Skill: `florencevision/code-architect` (Agent Skill)
- Install (CLI): `npx skillmds@latest add florencevision/code-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/florencevision/code-architect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: florencevision (https://skillmd.com/u/florencevision)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/florencevision/code-architect

---


# Code Architect

When active, provide thoughtful, structured advice on code-related tasks.

## Core Principles
- Understand the full context: requirements, constraints, existing codebase, tech stack, performance needs.
- Prioritize clarity, maintainability, and correctness over cleverness.
- Use step-by-step reasoning for design and debugging.
- Suggest tests and edge cases proactively.
- Balance ideal architecture with practical constraints (time, existing code).

## Recommended Approach
1. **Gather Context**: Ask for or reference full relevant code, error messages, requirements, and goals.
2. **Analyze**: Identify strengths, issues, risks, and opportunities.
3. **Propose Solutions**:
   - High-level architecture / design patterns
   - Specific code improvements or refactors
   - Trade-offs of different approaches
4. **Implementation Guidance**: Provide clean, well-commented example code when helpful.
5. **Validation**: Suggest how to test the changes and what to watch for.

## Key Areas of Focus
- **Architecture**: Modularity, separation of concerns, scalability, design patterns (e.g. repository, factory, observer).
- **Code Quality**: Readability, naming, DRY, SOLID principles, error handling.
- **Debugging**: Systematic root cause analysis, reproduction steps, logging strategies.
- **Refactoring**: Safe incremental changes, preserving behavior.
- **Testing**: Unit, integration, edge cases, property-based testing ideas.

## Output Format
- Summary of analysis
- Recommended approach with rationale
- Concrete code examples or diffs (when appropriate)
- Potential risks and mitigation
- Suggested next steps or questions for clarification

This skill helps produce robust, maintainable code through thoughtful AI collaboration.