CLI installer for the fcd-* Claude Code skill family. Drops skills into ~/.claude/skills/ in one command.

Fractal Co-Design (FCD)

Port-first. Surface before architecture. The same structural discipline at every scale.

Fractal Co-Design is a software design methodology that combines two complementary ideas:

Fractal Component Architecture (FCA) — structural. The same 8-part component model repeats from a function to a package to a system. Co-located documentation. Port-based dependency injection. Boundaries enforced by directory structure.
Extreme Co-Design (ECD) — process. Domains identified first, shared surfaces (ports) co-designed second, internal architecture follows third — constrained by the frozen ports.

Together: every cross-domain interaction is a co-designed, frozen port. Architecture decisions follow port correctness, not the other way around.

What this repo contains

Directory	What
`canon/`	The single source of truth — FCA reference (8-part component model, levels, principles) + ECD reference (extreme co-design, software translation, FCA synthesis)
`packages/`	Tools — `@fractal-co-design/fca-index@1.0` (semantic-search index over FCA codebases for token-efficient agent retrieval) and `@fractal-co-design/skills` (CLI installer for the `fcd-*` skill family)
`skills/`	Claude Code skills — the `fcd-*` family (`fcd-card`, `fcd-design`, `fcd-plan`, `fcd-surface`, `fcd-commission`, `fcd-debate`, `fcd-review`) and the `fca` knowledge skill
`apps/docs/`	The documentation site — published to https://vledicfranco.github.io/fractal-co-design/
`examples/`	Worked examples — custom language profiles, polyglot projects, surface-design walkthroughs

npx @fractal-co-design/skills install

This drops the fcd-* skill family into ~/.claude/skills/. Then use /fcd-design, /fcd-review, etc. in Claude Code.

The fastest path:

FCA — The Component — what an FCA component is, the 8 parts, the fractal claim
ECD — Extreme Co-Design — the process discipline that makes FCA tractable in teams
FCA — Applied Example — the methodology in action

Or start at the docs site which renders these with diagrams.

Component	Status
Canon (FCA + ECD)	✅ v0.1
Claude skills (`fcd-*`)	✅ v0.1
Docs site	✅ v0.1
`@fractal-co-design/skills` CLI	✅ v0.1
`@fractal-co-design/fca-index`	✅ v0.2 (migrated from `@methodts/fca-index@0.4`, now `@fractal-co-design/fca-index@1.0.0`)
Tools docs	✅ v0.2

MIT — see LICENSE.