carchitect

Solid

Structured architecture definition. Two modes — reverse-engineer from existing code or greenfield directed discovery. Produces .correctless/ARCHITECTURE.md with machine-referenceable entrypoints YAML and human-readable prose sections.

AI & Automation 61 stars 2 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
60
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# /carchitect — Architecture Definition Skill > **Shared constraints apply.** Before executing, read `_shared/constraints.md` from the parent of this skill's base directory. All constraints there apply to this skill. You are the architecture-definition agent. Your job is to produce a structured `.correctless/ARCHITECTURE.md` for the current project. You do NOT generate scaffolding or code — document only. Phase 0 is standalone: you do not modify any other skill's SKILL.md, frontmatter, or behavior. Downstream skill integrations are deferred to future phases. ## Before You Start ### Parse Arguments Check for command-line flags: - `--greenfield` — skip mode selection, enter greenfield mode directly. - `--reverse-engineer` — skip mode selection, enter reverse-engineer mode directly. - `--continue` — resume pattern review from where a previous session left off (within the current session only — pattern state is ephemeral, not persisted to an artifact. Cross-session continuation is not supported). If no flag is provided, proceed to the mode selection prompt. ### Existing Content Detection (R-015) Before starting, check if `.correctless/ARCHITECTURE.md` already exists with real content. **Definition of "real content"**: The file has no `{PLACEHOLDER}` markers AND has more than 20 lines of non-comment text. Non-comment lines are defined as lines not matching `^\s*$`, `^\s*<!--`, or `^\s*#`. If the file exists with real content, present these options — the skill does NOT si...

Details

Author
joshft
Repository
joshft/correctless
Created
2 months ago
Last Updated
yesterday
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

cupdate-arch

Update .correctless/ARCHITECTURE.md after features land. Use after /cdocs or when the codebase structure has changed.

61 Updated yesterday
joshft
Data & Documents Listed

architecture-md-builder

Build comprehensive ARCHITECTURE.md files for any repository following matklad's canonical guidelines. This skill should be used when creating codebase documentation that serves as a map for developers and AI agents, auditing existing repos for architectural understanding, or when users ask to 'document the architecture', 'create an architecture.md', or 'map this codebase'. Produces bird's eye views, ASCII/Mermaid diagrams, codemaps, invariants, and layer boundaries.

33 Updated 2 days ago
tdimino
AI & Automation Listed

architect

System design before any code is written — invoked via /architect; produces ADRs and ARCHITECTURE.md

0 Updated 6 days ago
puukis
AI & Automation Listed

design-architecture

Reviews the current codebase architecture and proposes improvements using four parallel specialist subagents: System Architect, Software Architect, Data Architect, and an Adversarial Architect that red-teams failure paths, LLM adversarial output scenarios, silent corruption risks, and invariant bypasses. Each subagent independently analyzes the codebase from their domain perspective, then their findings are consolidated into a living `architecture.md` file with a tracked to-do list and change log. Use this skill whenever the user asks to review, analyze, audit, or improve the architecture — or when they ask questions like "what should we change structurally?", "how is the system organized?", "what are our architecture problems?", "can you do an architecture review?", or "let's redesign X". Also trigger when the user mentions technical debt, structural improvements, security concerns, failure modes, vulnerabilities, or wants a second opinion on design decisions, even if they don't use the word "architecture".

2 Updated today
SenolIsci
Code & Development Listed

architecture-docs

Generate or refresh `/docs/architecture/` — the current-state source of architectural truth for this codebase, grounded in code and git history (NOT in .designs/). Produces an anchor-dense corpus (`invariants.md`, `idioms.md`, `trust-boundaries.md`, `seams.md`, `subsystems/*.md`, `history.md`, `gaps.md`) plus a high-level overview layer (C4 L1/L2 diagrams, sequence flows, Nygard ADRs). Every claim is anchored to a file:line or commit SHA, or labelled literally `"unknown — needs review"`. A bundled `validate.sh` mechanically enforces citation density and phase-completion gates. Used to ground future design reviews so they cannot silently drift away from established idioms.

0 Updated yesterday
stempeck