@decantr/cli 1.0.0-beta.5 → 1.0.0-beta.8

package/src/templates/task-modify.md.template

@@ -0,0 +1,171 @@
+# Task Context: Modifying Code
+
+**Enforcement Tier: Strict**
+
+You are modifying existing code in a Decantr project. ALL 5 guard rules are enforced exactly.
+
+---
+
+## Enforced Rules
+
+| # | Rule | Enforcement | Consequence of Violation |
+|---|------|-------------|--------------------------|
+| 1 | **Style** | STRICT | ERROR — Code rejected |
+| 2 | **Structure** | STRICT | ERROR — Code rejected |
+| 3 | **Layout** | STRICT | ERROR — Pattern order must match exactly |
+| 4 | **Recipe** | STRICT | ERROR — Code rejected |
+| 5 | **Density** | STRICT | WARNING — Flagged for review |
+
+## Violation Response Protocol
+
+When ANY rule would be violated:
+
+```
+1. STOP   — Do not generate code that violates rules
+2. EXPLAIN — State which rule and why
+3. OFFER  — Propose updating the essence
+4. WAIT   — Only proceed after essence is updated
+```
+
+### Example Responses
+
+**Theme violation:**
+```
+STOP: I cannot use theme "glassmorphism" because the essence specifies
+"{{THEME_STYLE}}". This would violate the Style guard rule.
+
+Would you like me to:
+1. Update the essence to use "glassmorphism" instead?
+2. Keep the current theme "{{THEME_STYLE}}"?
+```
+
+**Layout violation:**
+```
+STOP: I cannot reorder the patterns to [chart-grid, kpi-grid] because
+the essence specifies [kpi-grid, chart-grid] for this page.
+This would violate the Layout guard rule.
+
+Would you like me to:
+1. Update the essence with the new pattern order?
+2. Keep the original order [kpi-grid, chart-grid]?
+```
+
+**Never say "just this once."** The essence is the source of truth.
+
+## Before Modifying
+
+### 1. Read Current State
+
+```bash
+# Read the essence
+cat decantr.essence.json
+
+# Or use MCP
+decantr_read_essence()
+```
+
+### 2. Check Constraints
+
+For the page you're modifying, verify:
+
+- Page ID exists in `structure[]`
+- Shell matches the page's `shell` property
+- Patterns match the page's `layout[]` in order
+- Theme matches `theme.style`
+- Recipe matches `theme.recipe`
+
+### 3. Plan Changes
+
+Before writing code:
+
+1. List what changes are needed
+2. Check each change against guard rules
+3. If any would violate, STOP and propose essence updates
+4. Only proceed when all changes are compliant
+
+## Checklist
+
+Before modifying:
+
+- [ ] Page exists in essence structure
+- [ ] I know the exact layout order: `{{LAYOUT}}`
+- [ ] I will use theme: `{{THEME_STYLE}}`
+- [ ] I will use recipe: `{{THEME_RECIPE}}`
+- [ ] I will follow density: `{{DENSITY}}`
+
+During modification:
+
+- [ ] Every color/typography change uses the theme
+- [ ] Pattern order matches essence exactly
+- [ ] Spacing uses tokens, not arbitrary values
+- [ ] No new pages without essence declaration
+
+After modification:
+
+- [ ] Run `decantr validate`
+- [ ] Run `decantr audit` to check drift
+- [ ] Verify no warnings or errors
+
+## Spacing Enforcement
+
+In strict mode, spacing must match the density profile:
+
+| Density | Content Gap | Use These Tokens |
+|---------|-------------|------------------|
+| compact | `_gap2` | `_gap1`, `_gap2`, `_gap3` |
+| comfortable | `_gap4` | `_gap3`, `_gap4`, `_gap6` |
+| spacious | `_gap6` | `_gap4`, `_gap6`, `_gap8` |
+
+This project uses **{{DENSITY}}** density with `{{CONTENT_GAP}}` content gap.
+
+## Pattern Order Matters
+
+In strict mode, patterns MUST appear in the order specified in `layout[]`.
+
+If the essence says:
+```json
+"layout": ["kpi-grid", "chart-grid", "data-table"]
+```
+
+Then your code MUST render in that order:
+1. KPI Grid section
+2. Chart Grid section
+3. Data Table section
+
+Swapping `chart-grid` and `data-table` is a Layout guard violation.
+
+## Common Strict Mode Violations
+
+| Violation | What Happened | Fix |
+|-----------|---------------|-----|
+| "Theme mismatch" | Used different theme | Revert to `{{THEME_STYLE}}` |
+| "Page undefined" | Edited undeclared page | Add page to essence first |
+| "Layout order wrong" | Patterns out of order | Match `layout[]` exactly |
+| "Recipe mismatch" | Wrong decoration style | Use `{{THEME_RECIPE}}` |
+| "Density drift" | Wrong spacing values | Use `{{CONTENT_GAP}}` tokens |
+
+## Proposing Essence Changes
+
+If a change requires updating the essence:
+
+1. Explain what needs to change and why
+2. Show the before/after for the essence
+3. Wait for user approval
+4. Update the essence file
+5. Then proceed with code changes
+
+```
+To implement your request, I need to update the essence:
+
+Before:
+  "layout": ["kpi-grid", "chart-grid"]
+
+After:
+  "layout": ["hero", "kpi-grid", "chart-grid"]
+
+Shall I make this change?
+```
+
+---
+
+*Task context generated by Decantr CLI*

package/src/templates/task-scaffold.md.template

@@ -0,0 +1,65 @@
+# Task Context: Scaffolding
+
+**Enforcement Tier: Creative**
+
+You are scaffolding a new Decantr project. Guard rules are advisory only during initial scaffolding.
+
+---
+
+## Your Task
+
+Generate the initial project structure based on the essence specification.
+
+## Rules (Advisory)
+
+During scaffolding, the following rules are recommendations, not requirements:
+
+| Rule | Status | Guidance |
+|------|--------|----------|
+| Style | Advisory | Use the theme from essence, but creative variations are acceptable |
+| Structure | Advisory | Follow the page structure, add placeholder content |
+| Layout | Advisory | Use suggested patterns, order can be adjusted |
+| Recipe | Advisory | Apply recipe styles where possible |
+| Density | Advisory | Follow spacing guidelines loosely |
+
+## Checklist
+
+Before scaffolding:
+
+- [ ] Read `decantr.essence.json`
+- [ ] Understand the target framework ({{TARGET}})
+- [ ] Know the theme ({{THEME_STYLE}}) and mode ({{THEME_MODE}})
+- [ ] Review the page structure
+
+During scaffolding:
+
+- [ ] Create the shell layout ({{DEFAULT_SHELL}})
+- [ ] Generate pages from `structure[]`
+- [ ] Add pattern placeholders for each page's `layout[]`
+- [ ] Apply theme colors and typography
+- [ ] Set up routing based on page IDs
+
+After scaffolding:
+
+- [ ] Run `decantr validate` to check the essence
+- [ ] Verify each page renders correctly
+- [ ] Check theme consistency across pages
+
+## What to Generate
+
+{{SCAFFOLD_STRUCTURE}}
+
+## Next Steps
+
+After scaffolding is complete:
+
+1. Run the development server
+2. Verify all pages load
+3. Check theme consistency
+4. Run `decantr validate`
+
+Once verified, subsequent changes will use **{{GUARD_MODE}}** enforcement mode.
+
+---
+
+*Task context generated by Decantr CLI*