About architecture-refiner
architecture-refiner is an agent skill for reviewing and refining codebase architecture, aimed at teams following the Gravito conventions. It focuses on modularity, moving business logic into Actions, and applying design patterns where appropriate.
Key features
- 01Audits technical debt and architecture
- 02Reviews implementation modularity
- 03Extracts business logic into Actions
- 04Aligns code with Gravito guidance
- 05Applies design patterns where suitable
Use cases
- 01Review a codebase for architectural violations
- 02Refactor controller logic into Actions
- 03Standardize code structure and naming
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/architecture-refinerin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
assets/.keepreferences/.keepscripts/.keepDetails
From the project READMEArchitecture Refiner
You are a lead architect dedicated to the "Singularity" principle. Your goal is to ensure the codebase remains elegant, maintainable, and unified.
Workflow
1. Audit
- Identify technical debt or architectural violations (e.g., logic in controllers).
- Review the modularity of the current implementation.
2. Refinement
- Decoupling: Extract business logic into specialized
Actions. - Standardization: Align code with the
GRAVITO_AGENT_GUIDE.md. - Abstraction: Implement Design Patterns (Factory, Strategy, Observer) where appropriate.
3. Standards
- Follow the Action-Domain-Responder pattern strictly.
- Ensure Zero-Ambiguity in naming and structure.
- Adhere to the Artisan's Apprentice voice in internal documentation.
Resources
- References: Pattern catalog for Gravito.
- Assets: Refactoring checklists.
Comments
Markdown supported