@luizsantiago/fullstack-floor-map
v0.4.1
Published
Full Stack Floor Map companion for Spec Seatbelt — Floors layer Execute manuals plus a specialist skill catalog. Progressive loading, one layer per task.
Maintainers
Readme
Full Stack Floor Map
Full Stack Floor Map companion for Spec Seatbelt — map the stack into Floors (frontend, backend, data, analytics, data science), load one layer manual per Execute task, and optionally call one specialist from a 67-skill catalog (plus ≤2 references). Specialists enter only when called.
npm: @luizsantiago/fullstack-floor-map 0.4.1
Install
In your product repository (Node.js 18+. Python 3.10+ for gates):
npx @luizsantiago/spec-seatbelt install
npx @luizsantiago/fullstack-floor-map install
npx @luizsantiago/fullstack-floor-map doctorWhat install does
| Lands in your project | Purpose |
| --- | --- |
| .cursor/skills/*-engineering.md (+ .claude/) | Floors layer manuals (legacy Execute) |
| .cursor/skills/<specialist>/ | Specialist catalog (SKILL.md + references/) |
| .cursor/rules/fullstack-layer.mdc | One Floor + at most one specialist |
| .specs/seatbelt/scripts/validate_layer_routing.py | Layer gate (Fullstack-owned) |
| .specs/project/PROJECT.md | Stack + Layer registry (created if missing) |
Re-run Seatbelt install anytime — it does not delete Floors skills. Re-run Fullstack install to refresh layers, rule, gate, and catalog.
| Need | Command |
| --- | --- |
| Skills without Seatbelt yet | install --force |
| Refresh registry globs only | install --sync-registry |
| Check health | doctor |
| Check task Files vs floors | validate-layers <feature> |
How the pieces fit together
| Idea | Package | Role |
| --- | --- | --- |
| Seatbelt | @luizsantiago/spec-seatbelt | Spec, tasks, gates, Verify |
| Floors | this package (legacy) | Which floor a task lives on |
| Specialists | catalog in this package | Framework craft — load on demand |
Pairing: keep the feature vertical (one user path). Split tasks by floor — never mix apps/web and apps/api in one Files list.
Execute load: Seatbelt working set + one *-engineering.md + at most one specialist SKILL.md + ≤2 references/.
Verify: Seatbelt only — no Floors layers, no catalog specialists.
Plain-language tour: Home · Quick start · Concepts
Documentation
| Guide | Topic | | --- | --- | | Quick start | Install → registry → validate-layers → Execute | | Concepts | Floors, pairing, load policy | | Five floors | Layer manuals | | Specialist catalog | 67 skills, install ≠ load | | Layer routing gate | Gate paths & CLI | | Companion: Spec Seatbelt | Pairing contract | | CLI | Commands | | FAQ | Common questions | | Credits | Attribution |
Credits
This package adapts open ideas; Floors layer routing is original here.
| Source | License | How we use it |
| --- | --- | --- |
| jeffallan/claude-skills | MIT | Specialist catalog (SKILL.md + references/) |
| spec-seatbelt | MIT | Companion pairing, guide shape, Verify ownership |
Extended attribution: docs/guide/credits.md · NOTICE
License
MIT
