macca-method 2.0.0 → 2.1.2

package/.agents/skills/brainstorm-schema/SKILL.md

@@ -20,6 +20,7 @@ Run as `@Fachri` (Tech Lead). Use the shared persona profile in `../_shared/refe
 You are **@Fachri — Tech Lead**, a **Senior Database Architect** who designs efficient, correct, secure data structures.
 
 **Expertise:**
+
 - Database modeling (relational and non-relational)
 - Normalization, intentional denormalization, and trade-offs
 - Indexing strategies based on real access patterns
@@ -34,15 +35,17 @@ You are **@Fachri — Tech Lead**, a **Senior Database Architect** who designs e
 
 ## Shared Runtime Setup
 
+Paths written as `../...` below are relative to this SKILL.md's own folder, not the project's working directory - resolve them as a sibling of the folder that contains this file.
+
 Before any interview:
 
 1. Read `../_shared/references/language-config.md`.
 2. Read `../_shared/references/config-mutation.md`.
 3. Read `../_shared/references/brainstorm-session.md`.
 4. Read `../_shared/references/scope-rules.md`.
-4. Use `languagePreferences.communication.normalized` for chat.
-5. Use `languagePreferences.documents.normalized` for the final `project-context/schema.md`.
-6. Apply `brainstormPreferences.discussionMode`, `recommendations`, and `discoveryDepth` using the shared session policy.
+5. Use `languagePreferences.communication.normalized` for chat.
+6. Use `languagePreferences.documents.normalized` for the final `project-context/schema.md`.
+7. Apply `brainstormPreferences.discussionMode`, `recommendations`, and `discoveryDepth` using the shared session policy.
 
 ---
 
@@ -51,8 +54,8 @@ Before any interview:
 1. Load after `architecture.md` is complete.
 
 2. **Read existing project-context**:
-    - `project-context/PRD.md` — features and business rules that determine tables
-    - `project-context/architecture.md` — tech stack, ORM, database conventions
+   - `project-context/PRD.md` — features and business rules that determine tables
+   - `project-context/architecture.md` — tech stack, ORM, database conventions
 
 3. If `.agents/developer-config.json` exists and `developerPreferences.scope = "frontend"`, DO NOT create `schema.md`. Explain that database and schema work is outside the current scope, and that backend dependencies should be documented only through the `api.md` consumer contract.
 
@@ -71,9 +74,11 @@ Before any interview:
 Ask all five topics using the chosen pacing mode. First classify the persistence model from `architecture.md` as relational, document, key-value, graph, event store, or mixed. Adapt terminology and output to that model.
 
 ### 1. Database Conventions
-*"Before tables, let's align on conventions. Any preferences?"*
+
+_"Before tables, let's align on conventions. Any preferences?"_
 
 Collect:
+
 - **Identity strategy:** primary key, document ID, aggregate/stream ID, graph ID, or key format?
 - **Naming:** datastore-native naming for tables, collections, keys, node labels, streams, and fields?
 - **Audit/version metadata:** timestamps, version/revision, event metadata, or none?
@@ -82,9 +87,11 @@ Collect:
 - **Retention:** How long is data stored? Any anonymization or archival schedule?
 
 ### 2. Entity/Storage List
-*"What tables, collections, aggregates, nodes, or stores are needed?"*
+
+_"What tables, collections, aggregates, nodes, or stores are needed?"_
 
 Collect by persistence model:
+
 - **Relational:** tables and junction tables
 - **Document:** collections, document roots, and embedded subdocuments
 - **Key-value:** key spaces, key format, and value shape
@@ -94,9 +101,11 @@ Collect by persistence model:
 - **Multi-tenant systems only:** tenant key/boundary, isolation enforcement, cross-tenant constraints, export/deletion, and partition strategy
 
 ### 3. Fields & Data Types
-*"For each data structure, list fields and datastore-native data types."*
+
+_"For each data structure, list fields and datastore-native data types."_
 
 Collect per datastore-native structure:
+
 - Field names and datastore-native types
 - Validation/constraints appropriate to the selected model
 - Which columns contain sensitive data/PII?
@@ -105,9 +114,11 @@ Collect per datastore-native structure:
 - Expected record/document/event volume, growth rate, payload size, and retention horizon where material
 
 ### 4. Relationships and Data Placement
-*"What relationships exist, and should related data use foreign keys, references, embedding, edges, or another datastore-native pattern?"*
+
+_"What relationships exist, and should related data use foreign keys, references, embedding, edges, or another datastore-native pattern?"_
 
 Collect:
+
 - **Relational:** cardinality, foreign-key owner, and cascade/set-null/restrict behavior
 - **Document:** embedding vs references, document growth, and update atomicity
 - **Key-value:** key composition, lookup direction, and secondary-index needs
@@ -117,9 +128,11 @@ Collect:
 - Concurrency model: transaction boundary, optimistic version, lock/contention policy, duplicate update protection, or equivalent
 
 ### 5. Indexes & Performance
-*"Which access patterns, filters, sorts, traversals, stream reads, or lookups must be efficient? What datastore-native indexes or projections support them?"*
+
+_"Which access patterns, filters, sorts, traversals, stream reads, or lookups must be efficient? What datastore-native indexes or projections support them?"_
 
 Collect:
+
 - Required reads/writes and expected scale
 - Datastore-native indexes, projections, partitioning, traversal, or caching needed for those access patterns
 - Consistency and latency expectations that constrain the design
@@ -148,5 +161,4 @@ Adapt only sections that are applicable and preserve every required contract fro
 - If the user has no table plan yet, suggest tables from PRD features and user stories.
 - Render the final document in the configured document language
 
-
 ---

package/.agents/skills/brainstorm-schema/assets/schema.template.md

@@ -1,11 +1,13 @@
 # Database Schema
 
 ## Document Role
+
 - **Source of Truth:** Data model and persistence contract
 - **Primary Owner:** `brainstorm-schema`
 - **Out of Scope:** Endpoint behavior, UI rules, and code-level implementation details
 
 ## Persistence Profile
+
 - **Model:** Relational / Document / Key-value / Graph / Event store / Mixed
 - **Identity Strategy:** [UUID / key format / aggregate ID / stream ID]
 - **Naming:** [datastore-native naming rules]
@@ -14,21 +16,25 @@
 - **Timezone:** [UTC/local/N/A]
 
 ## Entity / Storage Map
-| Data ID | Structure | Type | Purpose | Trace to |
-|---------|-----------|------|---------|----------|
-| DATA-01 | `[name]` | Table / Collection / Key Space / Node / Stream / Aggregate | [purpose] | `FEAT-01 / BR-01` |
+
+| Data ID | Structure | Type                                                       | Purpose   | Trace to          |
+| ------- | --------- | ---------------------------------------------------------- | --------- | ----------------- |
+| DATA-01 | `[name]`  | Table / Collection / Key Space / Node / Stream / Aggregate | [purpose] | `FEAT-01 / BR-01` |
 
 ## Global Data Protection
-| Structure/Field | Category | Protection | Retention | Notes |
-|-----------------|----------|------------|-----------|-------|
-| [users.email] | PII | [encrypt/mask/plain] | [retention rule] | [notes] |
+
+| Structure/Field | Category | Protection           | Retention        | Notes   |
+| --------------- | -------- | -------------------- | ---------------- | ------- |
+| [users.email]   | PII      | [encrypt/mask/plain] | [retention rule] | [notes] |
 
 ## Scale, Tenancy & Concurrency
+
 - **Expected Scale/Growth:** [records, payload, growth]
 - **Tenant Isolation:** [N/A or enforcement model]
 - **Concurrency Strategy:** [transaction/version/lock/idempotency]
 
 ## Schema Evolution & Migration
+
 - **Compatibility:** [backward/forward policy]
 - **Migration Order:** [expand/backfill/switch/contract or equivalent]
 - **Backfill & Validation:** [strategy]
@@ -40,19 +46,22 @@
 ## Relational Section (include only for relational or mixed)
 
 ### Table DATA-01: `[table_name]`
+
 > **Trace to:** [FEAT-01 / BR-01]
 > **PII:** Yes / No
 > **Retention:** [policy]
 
-| Column | Type | Nullable | Default | Constraint | Notes |
-|--------|------|----------|---------|------------|-------|
-| id | UUID | No | gen_random_uuid() | PRIMARY KEY | |
-| [column] | [type] | [Yes/No] | [default] | [constraint] | [notes] |
+| Column   | Type   | Nullable | Default           | Constraint   | Notes   |
+| -------- | ------ | -------- | ----------------- | ------------ | ------- |
+| id       | UUID   | No       | gen_random_uuid() | PRIMARY KEY  |         |
+| [column] | [type] | [Yes/No] | [default]         | [constraint] | [notes] |
 
 **Relationships:**
+
 - [One-to-many / many-to-many / delete rule]
 
 **Indexes:**
+
 - [column/index purpose]
 
 ---
@@ -60,6 +69,7 @@
 ## Document Section (include only for document or mixed)
 
 ### Collection DATA-01: `[collection_name]`
+
 > **Trace to:** [FEAT-01 / BR-01]
 
 - **Root Document Shape:** [summary]
@@ -72,6 +82,7 @@
 ## Key-Value Section (include only for key-value or mixed)
 
 ### Key Space DATA-01: `[keyspace_name]`
+
 > **Trace to:** [FEAT-01 / BR-01]
 
 - **Key Format:** [pattern]
@@ -83,6 +94,7 @@
 ## Graph Section (include only for graph or mixed)
 
 ### Node / Edge DATA-01: `[node_or_edge_name]`
+
 > **Trace to:** [FEAT-01 / BR-01]
 
 - **Node/Edge Type:** [type]
@@ -94,6 +106,7 @@
 ## Event Store Section (include only for event-store or mixed)
 
 ### Aggregate / Stream DATA-01: `[stream_name]`
+
 > **Trace to:** [FEAT-01 / BR-01]
 
 - **Aggregate Boundary:** [summary]
@@ -102,8 +115,10 @@
 - **Ordering / Versioning:** [rules]
 
 ## Not Yet Modeled / Deferred
+
 - [Data area intentionally not yet modeled]
 
 ## Assumptions & Open Questions
+
 - [Assumption about structures, relationships, or data rules]
 - [Question that needs user confirmation]

package/.agents/skills/brainstorm-styleguide/SKILL.md

@@ -20,6 +20,7 @@ Run as `@Akram` (UI/UX Designer). Use the shared persona profile in `../_shared/
 You are a **Senior UI/UX Designer** who builds scalable, consistent design systems.
 
 **Expertise:**
+
 - Building design tokens (color, typography, spacing)
 - Tailwind CSS, CSS Modules, utility-first approaches
 - Accessibility (WCAG) and responsive design principles
@@ -39,19 +40,19 @@ This skill generates **StyleGuide.md** through an interactive interview. It prev
 1. Run this after the PRD and architecture are clear, or when discussing UI design.
 
 2. **Read existing project-context** before any user interaction:
-    - `project-context/PRD.md` — target platforms and referenced UI patterns
-    - `project-context/architecture.md` — chosen frontend tech stack
-    - If `.agents/developer-config.json` exists, read `developerPreferences.scope`
-
-3. **Shared Runtime Setup** — before the interview:
-    - Read `../_shared/references/language-config.md`.
-    - Read `../_shared/references/config-mutation.md`.
-    - Read `../_shared/references/brainstorm-session.md`.
-    - Read `../_shared/references/scope-rules.md`.
-    - Use `languagePreferences.communication.normalized` for chat.
-    - Use `languagePreferences.documents.normalized` for the final `project-context/StyleGuide.md`.
-    - Apply `brainstormPreferences.discussionMode`, `recommendations`, and `discoveryDepth` using the shared session policy.
-    - For this skill: announce that there are 7 topics, ask for pacing (one by one / three at once / all at once), and ask for recommendation preference if it is not already stored.
+   - `project-context/PRD.md` — target platforms and referenced UI patterns
+   - `project-context/architecture.md` — chosen frontend tech stack
+   - If `.agents/developer-config.json` exists, read `developerPreferences.scope`
+
+3. **Shared Runtime Setup** — before the interview (paths written as `../...` are relative to this SKILL.md's own folder, not the project's working directory):
+   - Read `../_shared/references/language-config.md`.
+   - Read `../_shared/references/config-mutation.md`.
+   - Read `../_shared/references/brainstorm-session.md`.
+   - Read `../_shared/references/scope-rules.md`.
+   - Use `languagePreferences.communication.normalized` for chat.
+   - Use `languagePreferences.documents.normalized` for the final `project-context/StyleGuide.md`.
+   - Apply `brainstormPreferences.discussionMode`, `recommendations`, and `discoveryDepth` using the shared session policy.
+   - For this skill: announce that there are 8 topics, ask for pacing (one by one / three at once / all at once), and ask for recommendation preference if it is not already stored.
 
 4. If scope = `backend`, DO NOT create `StyleGuide.md`. Explain that UI work is outside the current scope.
 
@@ -59,25 +60,29 @@ This skill generates **StyleGuide.md** through an interactive interview. It prev
 
 6. After all topics are complete, create `project-context/StyleGuide.md` (create `project-context/` if needed).
 
-   > ⚠️ **If the file already exists:** ask the user before overwriting — "(A) Replace the entire file, (B) cancel and review first." Wait for the answer.
+   > ⚠️ **If the file already exists:** "(A) Overwrite all, (B) Cancel and review first." Wait for the answer.
 
 7. Summarize the result and provide next steps.
 
 ## Interview Topics (8)
 
 ### 1. CSS Framework
-**Ask:** *"What CSS framework is used: Tailwind, Bootstrap, or custom CSS?"*
+
+**Ask:** _"What CSS framework is used: Tailwind, Bootstrap, or custom CSS?"_
 
 **Collect:**
+
 - If Tailwind: v3 or v4?
 - If Bootstrap: preferred version?
 - Or CSS modules / styled-components / vanilla CSS?
 - Utility-first or component-based?
 
 ### 2. Color Palette
-**Ask:** *"What color scheme do you want? List primary, secondary, accent, and status colors."*
+
+**Ask:** _"What color scheme do you want? List primary, secondary, accent, and status colors."_
 
 **Collect:**
+
 - Primary color (brand)
 - Secondary color (accent)
 - Background color
@@ -87,9 +92,11 @@ This skill generates **StyleGuide.md** through an interactive interview. It prev
 - Hex/RGB codes if available
 
 ### 3. Typography
-**Ask:** *"What fonts do you want? Any difference between headings and body text?"*
+
+**Ask:** _"What fonts do you want? Any difference between headings and body text?"_
 
 **Collect:**
+
 - Heading font family (for example Inter, Poppins, Roboto)
 - Body font family
 - Font sizes for H1, H2, H3, H4, body, caption
@@ -97,18 +104,22 @@ This skill generates **StyleGuide.md** through an interactive interview. It prev
 - Google Fonts or custom fonts?
 
 ### 4. Spacing System
-**Ask:** *"What spacing scale do you want? Is the base unit 4px, 8px, or 16px?"*
+
+**Ask:** _"What spacing scale do you want? Is the base unit 4px, 8px, or 16px?"_
 
 **Collect:**
+
 - Base spacing unit (4px or 8px?)
 - Use default Tailwind scale or custom?
 - Padding/margin for containers, cards, buttons
 - Spacing between page sections
 
 ### 5. Component Style
-**Ask:** *"How should components look? For buttons, cards, and inputs, what border and shadow style do you want?"*
+
+**Ask:** _"How should components look? For buttons, cards, and inputs, what border and shadow style do you want?"_
 
 **Collect:**
+
 - Border radius (rounded-sm, rounded-md, rounded-full, square)
 - Button style (filled, outline, ghost) and sizes (sm, md, lg)
 - Card style (border, shadow, background)
@@ -117,25 +128,31 @@ This skill generates **StyleGuide.md** through an interactive interview. It prev
 - Transitions/animation: duration and easing (for example `150ms ease-in-out`)
 
 ### 6. Responsive & Breakpoints
-**Ask:** *"What responsive breakpoints are used? Mobile-first or desktop-first?"*
+
+**Ask:** _"What responsive breakpoints are used? Mobile-first or desktop-first?"_
 
 **Collect:**
+
 - Mobile-first (default) or desktop-first?
 - Breakpoint values (or use Tailwind defaults: sm:640, md:768, lg:1024, xl:1280)
 - Layout changes per breakpoint (for example sidebar collapses below md)
 
 ### 7. Iconography
-**Ask:** *"What icon library is used: Lucide, Heroicons, FontAwesome, or custom?"*
+
+**Ask:** _"What icon library is used: Lucide, Heroicons, FontAwesome, or custom?"_
 
 **Collect:**
+
 - Preferred icon library
 - Default icon size (16px, 20px, 24px)
 - Need custom SVG icons?
 
 ### 8. Accessibility, Localization & Operational States
-**Ask:** *"Which accessibility target and non-happy-path states must the UI support: loading, empty, error, forbidden, offline, reduced motion, keyboard, screen reader, or localization?"*
+
+**Ask:** _"Which accessibility target and non-happy-path states must the UI support: loading, empty, error, forbidden, offline, reduced motion, keyboard, screen reader, or localization?"_
 
 **Collect:**
+
 - Accessibility target from PRD (for example WCAG AA), keyboard order, visible focus, labels, contrast, touch targets, and reduced motion
 - Loading/skeleton, empty, error, disabled/read-only, permission-denied, offline, and partial-data behavior that applies to primary surfaces
 - Supported locales from PRD; text expansion, pluralization, date/number/currency/timezone formatting, and RTL only when relevant
@@ -152,6 +169,7 @@ Adapt only sections that are applicable and preserve every required contract fro
 ## Next Steps
 
 After StyleGuide.md is complete:
+
 1. Run `brainstorm-rules` to create coding standards
 2. Then: `brainstorm-task` to create Task.md
 

package/.agents/skills/brainstorm-styleguide/assets/StyleGuide.template.md

@@ -3,136 +3,152 @@
 > **Framework:** [CSS Framework] | **Approach:** [Utility-first / Component-based]
 
 ## Document Role
+
 - **Source of Truth:** Visual system and UI conventions for this project
 - **Primary Owner:** `brainstorm-styleguide`
 - **Out of Scope:** Backend logic, API contracts, and non-UI technical architecture
 
 ## Supported Surfaces
-| Surface | Included? | Notes |
-|---------|-----------|-------|
-| Web app | Yes / No | [notes] |
-| Admin panel | Yes / No | [notes] |
-| Marketing site | Yes / No | [notes] |
-| Email / PDF / export | Yes / No | [notes] |
+
+| Surface              | Included? | Notes   |
+| -------------------- | --------- | ------- |
+| Web app              | Yes / No  | [notes] |
+| Admin panel          | Yes / No  | [notes] |
+| Marketing site       | Yes / No  | [notes] |
+| Email / PDF / export | Yes / No  | [notes] |
 
 ---
 
 ## 1. CSS Framework
+
 - **Framework:** [Tailwind CSS v3 / Bootstrap 5 / CSS Modules / etc.]
 - **Version:** [version]
 - **Notes:** [Additional rules]
 
 ## 2. Color Palette
-| Role | Hex | Tailwind | Description |
-|------|-----|----------|-------------|
-| Primary | `#xxx` | `bg-blue-600` | Main brand |
-| Secondary | `#xxx` | `bg-gray-600` | Accent |
-| Background | `#xxx` | `bg-gray-50` | Page background |
-| Surface | `#xxx` | `bg-white` | Card/panel background |
-| Primary Text | `#xxx` | `text-gray-900` | Main text |
-| Secondary Text | `#xxx` | `text-gray-500` | Secondary text |
-| Error | `#xxx` | `text-red-500` | Error message |
-| Success | `#xxx` | `text-green-500` | Success message |
-| Warning | `#xxx` | `text-yellow-500` | Warning message |
-| Info | `#xxx` | `text-blue-500` | Info message |
+
+| Role           | Hex    | Tailwind          | Description           |
+| -------------- | ------ | ----------------- | --------------------- |
+| Primary        | `#xxx` | `bg-blue-600`     | Main brand            |
+| Secondary      | `#xxx` | `bg-gray-600`     | Accent                |
+| Background     | `#xxx` | `bg-gray-50`      | Page background       |
+| Surface        | `#xxx` | `bg-white`        | Card/panel background |
+| Primary Text   | `#xxx` | `text-gray-900`   | Main text             |
+| Secondary Text | `#xxx` | `text-gray-500`   | Secondary text        |
+| Error          | `#xxx` | `text-red-500`    | Error message         |
+| Success        | `#xxx` | `text-green-500`  | Success message       |
+| Warning        | `#xxx` | `text-yellow-500` | Warning message       |
+| Info           | `#xxx` | `text-blue-500`   | Info message          |
 
 **Dark Mode:** [Supported / Not supported]
 
 ## 3. Typography
+
 - **Heading Font:** [Font Name] — via [Google Fonts / local]
 - **Body Font:** [Font Name] — via [Google Fonts / local]
 
-| Level | Size | Weight | Line Height |
-|-------|------|--------|-------------|
-| H1 | [size] | [weight] | [line-height] |
-| H2 | [size] | [weight] | [line-height] |
-| H3 | [size] | [weight] | [line-height] |
-| H4 | [size] | [weight] | [line-height] |
-| Body | [size] | regular | [line-height] |
-| Small | [size] | regular | [line-height] |
-| Caption | [size] | regular | [line-height] |
+| Level   | Size   | Weight   | Line Height   |
+| ------- | ------ | -------- | ------------- |
+| H1      | [size] | [weight] | [line-height] |
+| H2      | [size] | [weight] | [line-height] |
+| H3      | [size] | [weight] | [line-height] |
+| H4      | [size] | [weight] | [line-height] |
+| Body    | [size] | regular  | [line-height] |
+| Small   | [size] | regular  | [line-height] |
+| Caption | [size] | regular  | [line-height] |
 
 ## 4. Spacing System
+
 - **Base Unit:** [4px / 8px]
 - **Scale:** [Tailwind Default / Custom]
 
-| Token | Value | Tailwind |
-|-------|-------|----------|
-| xs | [4px] | `p-1` |
-| sm | [8px] | `p-2` |
-| md | [16px] | `p-4` |
-| lg | [24px] | `p-6` |
-| xl | [32px] | `p-8` |
-| 2xl | [48px] | `p-12` |
+| Token | Value  | Tailwind |
+| ----- | ------ | -------- |
+| xs    | [4px]  | `p-1`    |
+| sm    | [8px]  | `p-2`    |
+| md    | [16px] | `p-4`    |
+| lg    | [24px] | `p-6`    |
+| xl    | [32px] | `p-8`    |
+| 2xl   | [48px] | `p-12`   |
 
 ## 5. Component Style
+
 - **Border Radius:** [rounded-md / rounded-lg / none]
 - **Shadow:** [shadow-sm / shadow-md / none]
 
 ## Component Inventory
-| Component | Status | Notes |
-|-----------|--------|-------|
-| Button | Defined | [notes] |
-| Card | Defined | [notes] |
-| Input | Defined | [notes] |
-| Modal | Defined / Deferred | [notes] |
-| Table | Defined / Deferred | [notes] |
+
+| Component | Status             | Notes   |
+| --------- | ------------------ | ------- |
+| Button    | Defined            | [notes] |
+| Card      | Defined            | [notes] |
+| Input     | Defined            | [notes] |
+| Modal     | Defined / Deferred | [notes] |
+| Table     | Defined / Deferred | [notes] |
 
 ### Button
-| Variant | Style |
-|---------|-------|
-| Primary | [bg-primary text-white rounded-md px-4 py-2] |
-| Secondary | [outline / ghost] |
-| Danger | [bg-error text-white] |
+
+| Variant   | Style                                        |
+| --------- | -------------------------------------------- |
+| Primary   | [bg-primary text-white rounded-md px-4 py-2] |
+| Secondary | [outline / ghost]                            |
+| Danger    | [bg-error text-white]                        |
 
 ### Card
+
 - Background: [surface color]
 - Border: [border style]
 - Shadow: [shadow level]
 - Padding: [padding value]
 
 ### Input
+
 - Border: [border style]
 - Focus: [focus ring style]
 - Error state: [error border + message style]
 
 ### Transition & Animation
+
 - **Default Duration:** [150ms / 200ms / 300ms]
 - **Easing:** [ease-in-out / ease-out]
 - **Pattern:** `transition-all duration-150 ease-in-out`
 
 ## 6. Responsive & Breakpoints
+
 - **Approach:** [Mobile-first / Desktop-first]
 
-| Breakpoint | Value | Description |
-|------------|-------|-------------|
-| sm | [640px] | Small tablet |
-| md | [768px] | Tablet |
-| lg | [1024px] | Desktop |
-| xl | [1280px] | Large desktop |
+| Breakpoint | Value    | Description   |
+| ---------- | -------- | ------------- |
+| sm         | [640px]  | Small tablet  |
+| md         | [768px]  | Tablet        |
+| lg         | [1024px] | Desktop       |
+| xl         | [1280px] | Large desktop |
 
 **Layout Rules:**
+
 - [Description of layout changes per breakpoint]
 
 ## 7. Iconography
+
 - **Library:** [Lucide React / Heroicons / FontAwesome / etc.]
 - **Default Size:** [20px / 24px]
 - **Import Pattern:** `import { IconName } from 'lucide-react'`
 - **Notes:** [Rules for icon usage]
 
 ## 8. Accessibility, Localization & Operational States
+
 - **Accessibility Target:** [PRD target / WCAG level]
 - **Keyboard & Focus:** [rules]
 - **Screen Reader & Labels:** [rules]
 - **Reduced Motion:** [behavior]
 
-| State | Required UI Behavior | Recovery/Action |
-|-------|----------------------|-----------------|
-| Loading | [skeleton/progress] | [wait/cancel] |
-| Empty | [message/CTA] | [next action] |
-| Error | [message/retry] | [recovery] |
-| Forbidden | [explanation] | [request access/back] |
-| Offline/Partial | [if applicable] | [sync/retry] |
+| State           | Required UI Behavior | Recovery/Action       |
+| --------------- | -------------------- | --------------------- |
+| Loading         | [skeleton/progress]  | [wait/cancel]         |
+| Empty           | [message/CTA]        | [next action]         |
+| Error           | [message/retry]      | [recovery]            |
+| Forbidden       | [explanation]        | [request access/back] |
+| Offline/Partial | [if applicable]      | [sync/retry]          |
 
 - **Locales & Text Expansion:** [supported locales or N/A]
 - **Formatting:** [date/number/currency/timezone]
@@ -140,8 +156,10 @@
 - **UI Performance Budget:** [fonts/assets/motion/render constraints]
 
 ## Non-Goals / Not Yet Defined
+
 - [UI areas intentionally outside this style guide]
 
 ## Assumptions & Open Questions
+
 - [Assumption about branding, assets, or surface coverage]
 - [Question that needs confirmation]