Wiring Map
Execution coordinates for the engineering agent. All paths relative to the stackmat.es implementation worktree.
Pages
| Screen | Route | File | Pattern to Copy |
|---|---|---|---|
| Forms Index | /forms | BLOCKER: stackmat.es page routing pattern TBD — likely src/app/forms/page.tsx or Docusaurus docs/forms/index.md | Copy structure from existing component index pages |
| Standard Process | /forms/standard-process | BLOCKER: depends on Forms Index routing decision | Copy layout from existing pattern documentation pages |
| Shipping Checklist | /forms/checklist | BLOCKER: depends on Forms Index routing decision | Copy from existing checklist-style pages (anti-patterns page) |
| CRM Contact Pattern | /patterns/crm/contact-form | BLOCKER: exact current CRM page paths need verification | Rewrite in place — preserve URL |
| Meeting Agenda Pattern | /patterns/meetings/agenda | BLOCKER: depends on pattern page routing decision | Copy from existing pattern pages (e.g., CRM patterns after rewrite) |
Components
| Component | File | Serves (Screen Contract ref) |
|---|---|---|
| Form atoms (Input, Select, Textarea, Checkbox) | BLOCKER: exact @stackmates/ui form atom paths TBD | R1, R2, M2 |
| FormShell organism | BLOCKER: exact @stackmates/ui FormShell path TBD | M3 |
| MeetingAgenda organism | New — BLOCKER: file path depends on whether it goes in lib or app | M1-M6 |
Server Actions
No server actions. All form submissions go to console.log per Prime Directive constraints.
Infrastructure
| Layer | File | Purpose |
|---|---|---|
| Sidebar config | BLOCKER: stackmat.es sidebar configuration file TBD | Restructure forms navigation to single entry |
| Tailwind theme | BLOCKER: stackmat.es Tailwind config path TBD | Verify @theme bridge tokens resolve for form components |
Existing Tests
| Type | File | Covers |
|---|---|---|
| Storybook stories | BLOCKER: form atom story file paths TBD | Form atom rendering + accessibility (regression baseline) |
| BLOCKER | No known form integration tests | S4 (CRM rewrite), S5 (meeting form) need new test files |
Seeds and Fixtures
No data layer. All form submissions log to console. No seed data needed.
Implementation Guardrails
- Every page imports from
@stackmates/ui— zero raw HTML form elements - No
_components/local directory under any page — if it needs a component, it goes in the lib - CRM page URLs must not change during rewrite
- Use Tailwind v4.1
@themetokens — no arbitrary bracket values - L:R ratio target 1:3 or better for every pattern page
console.logoralertfor form submissions — no API connections- Anti-pattern documentation must not be moved or removed during nav restructure
- FormShell is the form wrapper — do not create a competing wrapper