v3.0.0 - Skill Overhaul

v3.0.0

Refactor: overhauled skill structure

Bug fix

The .skill file format was not cleanly accepted by Claude.ai for skill uploads. The packaging format has been changed to .zip. The .gitignore has been updated accordingly, and the README now includes correct ZIP install guidance with the expected folder structure.

Skill structure overhaul

SKILL.md has been substantially condensed and rewritten. The interview workflow, document generation guidance, and consistency rules have been extracted into dedicated reference files that are loaded on demand — keeping the main skill file lean while making each concern easier to find and maintain.

New files

• references/INTERVIEW.md — Full interview workflow: user-provided context handling, stack-specific follow-up questions, pattern choice presentation, restructuring analysis, and architecture review.
• references/DOC-TEMPLATE.md — Section-by-section document authoring guide with output scaling rules (small / medium / large) and the optional AI-ready implementation spec format.
• references/CONSISTENCY.md — 9-point consistency checklist, run before every delivery and after every revision.

Other changes

• marketplace.json: version bumped to 3.0.0, $schema field added, description updated.

Upgrading from v2.1.0

If you installed via .skill file, re-download and install using the .zip format instead. No breaking changes to skill behavior. If you've forked or modified SKILL.md directly, note that interview and document generation logic now lives in the new reference files.

Full Changelog: v2.1.0...v3.0.0

v2.0.0 - Major Revisions

Whats New

Skill.md Revisions

• Replace domain detection with stack detection (honest scope, unrecognized stack fallback)
• Add three-way project routing: greenfield / style reference / restructuring
• Add Step 2R: complete restructuring workflow (analysis phase, migration tasks, before/after comparisons)
• Add stack-specific interview questions (Unity, Node.js/Express, C++/CMake)
• Add interview depth rules (1 batch + 1 follow-up max)
• Add pattern choices: present 2-3 valid architectural options per stack during interview
• Add user unfamiliarity handling (accessible patterns, learning curve flags, progressive tasks)
• Add output scaling: small projects get collapsed template, large projects get full treatment
• Strengthen Simplicity Check: must apply findings before presenting, not just flag them
• Add audience-aware appendix (glossary scales with user knowledge)
• Add domain-specific diagram defaults per stack
• Add Implementation Spec: optional AI-ready output for Claude Code / Cursor

Reference files renamed + expanded:

• webdev.md → nodejs-express.md (+API versioning, rate limiting, WebSocket, monorepo, 4 pattern choices)
• gamedev.md → unity.md (+proc-gen, time/cycle systems, save systems, audio architecture, 3 pattern choices)
• cpp-cmake.md (+3 pattern choices: project org, error handling, dependency management)

Performance evaluation

• Avg 6.7/10 → 8.8/10 across 3 test cases

QA tested

• Greenfield C++ CLI, Express restructure, Node.js with style reference

Install via Claude Code

/plugin marketplace add CarterIrish/code-architecture-skill
/plugin install code-architecture@code-architecture-marketplace

Full Changelog: v1.1.1...V2.0.0

v1.1.1 - Fix marketplace manifest

Fixes the .claude-plugin/marketplace.json schema so marketplace install works correctly. Added required owner field.

Install via Claude Code

/plugin marketplace add CarterIrish/code-architecture-skill
/plugin install code-architecture@code-architecture-marketplace

No skill changes from v1.1.0.

Full Changelog: v1.1.0...v1.1.1

v1.1.0

What's new

• Claude Code marketplace support — Install with two commands, no manual file copying:

  /plugin marketplace add CarterIrish/code-architecture-skill
  /plugin install code-architecture@code-architecture-marketplace

• Updated README with installation instructions for Claude Code, claude.ai, and manual install

No skill changes

The skill itself (SKILL.md and reference files) is unchanged from v1.0.0. This release only adds the .claude-plugin/marketplace.json manifest for marketplace discovery.

Full Changelog: v1.0.0...v1.1.0

Code Architecture Planner v1.0.0

Code Architecture Planner v1.0.0

A Claude skill that plans and documents software architecture through a collaborative, iterative process.

Features

• 9-section architecture document — Project overview, scope boundaries, tech stack, folder structure, components, data flow, tradeoffs, simplicity check, implementation tasks, and appendix
• Mermaid diagram — Visual system architecture generated alongside the doc
• 3 domain reference files — Web (Node.js/Express), Game (Unity/C#), C++/CMake — auto-detected from context
• Simplicity Check — Actively audits the architecture for over-engineering and flags where simpler approaches work
• Scope boundaries as thresholds — Out-of-scope features include upgrade paths so you know the cost of adding them later
• Collaborative pushback — Advocates for better approaches when warranted, explains the tradeoff, respects your decision
• 9-point consistency check — Internal audit catches contradictions between sections before presenting output
• Iterative feedback — Targeted revisions without full regeneration, tracks approved sections
• Clarification escape hatches — Every multiple-choice question includes an option to get more detail before deciding

Installation

Download code-architecture.skill below and drag it into a Claude conversation.

Built with

Developed iteratively using the skill-creator framework — drafted, tested against 4 domain-specific prompts plus a real project (personal dashboard with plugin system), revised through multiple feedback cycles, and packaged.