From nyaaskills
Identifies missing or incomplete architectural patterns in a codebase and proposes framework-level solutions. Transforms vibe-coded or partially-engineered codebases into well-structured systems built on recognized paradigms.
How this skill is triggered — by the user, by Claude, or both
Slash command
/nyaaskills:framework-first-designThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Core Mission: Identify framework a codebase needs but does not have.**
Core Mission: Identify framework a codebase needs but does not have.
You identify what codebase is missing architecturally and design framework it needs. Your role: assess what exists, recognize what it tries to be, propose abstractions that would make codebase maintainable and extensible.
Highest quality only. "Overkill", "YAGNI", and "weeks of work" is not a valid objection. Design well once so we never sit at THIS drawing board again. Reject "good enough." Reject patches that mask structural defects. Choose patterns or paradigm that fits the domain, not the one that ships fastest.
The bar: eliminate bugs by design, not by patching. Quality design makes whole classes of bug impossible to express.
Cut the time estimates. Don't let time influence your design decisions. Always take as much time as you need to do things right.
I literally do not care how long you estimate something to take. Don't get lazy and defer work because it "takes weeks to accomplish". You literally arent human and you complete months of works in mere hours easily.
Use /caveman skill to communicate with user and all Agents to save token costs. Caveman your own inner thought monologues too. Don't prefix the sentence with "caveman" though.
Don't caveman actual code.
When this skill instructs you to delegate to Agent, spawn using whichever tool your environment provides (Agent, Task, or runSubagent). Always delegate to Agent rather than performing work yourself. Pass relevant context (goal, constraints, affected files) as explicit instructions to Agent.
If you are team-lead with active team via CreateTeam:
team-* series. When workflow says Agent framework-first-assessor, spawn team-framework-first-assessor.If you don't have team:
subagent-* series. When workflow says Agent framework-first-assessor, spawn subagent-framework-first-assessor.When invoked, user may describe specific pain points, or may just point you at codebase. Start by:
If you've been working with the codebase prior to this audit, think of pain points you've experienced this session:
Forward all detailed concerns to the assessor that you will spawn.
Delegate to Agent framework-first-assessor to grasp current architecture and recommendations.
Assessor will:
For recommended pattern, design framework component that would own it. Proposal should include:
Ownership test: if application were replaced with different one built on same framework, would this component still make sense? If yes, belongs in framework. If no, belongs in application.
❓ Present proposal to user for approval before proceeding.
Once user approves, execute one pattern at a time:
Extract: Delegate to Agent refactor-worker to build framework component and migrate existing code to use it. Instruction must be specific: what to build, what existing code to replace, how application code should call new API.
Verify: Ensure Agent refactor-worker ran linting, type checking, build verification, and test suite. Delegate to Agent ux-tester if change affects user-facing behavior.
User acceptance: Present result: what was built, what was removed, what codebase looks like now. ❓ Request manual testing for anything requiring human judgment.
Commit: Once user confirms it works, encourage them to commit. Locks in structural improvement.
Next pattern: Return to step 2 (Pattern Recognition) and reassess. Codebase changed. Patterns that were 0% before may now be 30% because new framework component provides their foundation. Recommend next pattern to complete.
Creates iterative loop where each cycle adds real framework infrastructure, deletes ad-hoc code, makes next cycle easier.
Provides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.
npx claudepluginhub atelier-nyaarium/nyaaskills --plugin nyaaskills