Replace Agent Dialog system with single Design Log

Remove Agent Dialog Gate from all 9 activity workflows and the main
workflow.md initialization. Replace with a single 00-design-log.md file
containing Backlog, Current, Design Loop Status, and Log sections.

- Rewrite workflow.md adaptive dashboard to read from design log only
- Create 00-design-log.template.md, delete old 00-progress.template.md
- Update installer.js: agent-experiences folder replaces agent-dialogs
- Rename 00-progress.md → 00-design-log.md across all phases (1-5)
- Update step files to use agent experiences instead of agent dialogs
- 30 files changed, net reduction of ~140 lines of ceremony

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Mårten Angner 2026-02-27 10:39:23 +01:00
parent d2599c91b4
commit a4ac572451
30 changed files with 160 additions and 241 deletions

View File

@ -157,14 +157,14 @@ Store all as `project_context` and `working_relationship` in outline.
**Create folder structure:**
1. Create root folder: `{{root_folder}}/`
2. Create progress folder: `{{root_folder}}/_progress/`
3. Create agent dialogs folder: `{{root_folder}}/_progress/agent-dialogs/`
3. Create agent experiences folder: `{{root_folder}}/_progress/agent-experiences/`
4. Create phase folders (greenfield vs brownfield)
5. Create D-Design-System subfolders
6. Install folder guide files from templates
**Generate `{{root_folder}}/_progress/wds-project-outline.yaml`** with all configuration values.
**Fill in `00-progress.md`** with initial Phase 0 entry.
**Fill in `00-design-log.md`** with initial Phase 0 entry.
### 11. Summary & Next Steps

View File

@ -0,0 +1,59 @@
# Design Log
**Project:** {{project_name}}
**Started:** {{date}}
**Method:** Whiteport Design Studio (WDS)
---
## Backlog
> Business-value items. Add links to detail files if needed.
- [ ] Complete product brief — Phase 1
- [ ] Define trigger map — Phase 2
- [ ] Create user scenarios — Phase 3
---
## Current
| Task | Started | Agent |
|------|---------|-------|
| — | — | — |
**Rules:** Mark what you start. Complete it when done (move to Log). One task at a time per agent.
---
## Design Loop Status
> Per-page design progress. Updated by agents at every design transition.
| Scenario | Step | Page | Status | Updated |
|----------|------|------|--------|---------|
**Status values:** `discussed``wireframed``specified``explored``building``built``approved` | `removed`
**How to use:**
- **Append a row** when a page reaches a new status (do not overwrite — latest row per page is current status)
- **Read on startup** to see where the project stands and what to suggest next
---
## Log
### {{date}} — Project initialized (Phase 0)
- Type: {{greenfield/brownfield}}
- Complexity: {{product_complexity}}
- Tech stack: {{tech_stack}}
---
## About This Folder
- **This file** — Single source of truth for project progress
- **agent-experiences/** — Compressed insights from design discussions (dated files)
- **wds-project-outline.yaml** — Project configuration from Phase 0 setup
**Do not modify `wds-project-outline.yaml`** — it is the source of truth for project configuration.

View File

@ -1,72 +0,0 @@
# Design Process Log
> Track progress, decisions, and agent handoffs across the design process.
**Project:** {{project_name}}
**Started:** {{date}}
**Method:** Whiteport Design Studio (WDS)
---
## About This Folder
The `_progress` folder is the memory of your design process. It tracks what happened, when, and why — so any agent or human can pick up where you left off.
**Contents:**
- **This file** — Design log with phase progress and key decisions
- **agent-dialogs/** — Conversation records between agents and humans, persisted across sessions
- **wds-project-outline.yaml** — Project configuration from Phase 0 setup
**Learn more:** WDS Course Module 02 (Installation & Setup), Lesson 4: WDS Initialization
---
## For Agents
**Your dialog files go in `agent-dialogs/`.** Name them: `YYYY-MM-DD-agent-topic.md`
When you complete a phase milestone, add an entry to the Progress section below. When the user makes a key decision, record it in Key Decisions.
**Do not modify `wds-project-outline.yaml`** — it is the source of truth for project configuration.
---
## Progress
### {{date}} — Project Initialized (Phase 0)
**Configuration:**
- Type: {{greenfield/brownfield}}
- Complexity: {{product_complexity}}
- Tech Stack: {{tech_stack}}
- Brief Level: {{brief_level}}
**Next:** Phase 1 — Product Brief
---
## Design Loop Status
> Per-page design progress. Updated by agents at every design transition.
| Scenario | Step | Page | Status | Updated |
|----------|------|------|--------|---------|
**Status values:** `discussed``wireframed``specified``explored``building``built``approved` | `removed`
**How agents use this table:**
- **Append a row** when a page reaches a new status (do not overwrite — the latest row per page is the current status)
- **Read on startup** to determine where the project stands and what to suggest next
- **The latest row per Step** is the current status for that page
---
## Key Decisions
| Date | Decision | Context | Made By |
|------|----------|---------|---------|
| {{date}} | Project initialized | Phase 0 setup | {{agent}} |
---
_Updated using Whiteport Design Studio (WDS) methodology_

View File

@ -49,7 +49,7 @@ Document Phase 1 completion in the project design log - the project's memory.
### 1. Read the Current Log
Read `{output_folder}/_progress/00-progress.md` to understand existing entries and format.
Read `{output_folder}/_progress/00-design-log.md` to understand existing entries and format.
### 2. Append Progress Entry

View File

@ -42,7 +42,7 @@ Document Phase 2: Trigger Mapping completion in the project design log, listing
## EXECUTION PROTOCOLS:
- 🎯 Read current design log and append progress entry
- 💾 Update {output_folder}/_progress/00-progress.md
- 💾 Update {output_folder}/_progress/00-design-log.md
- 📖 List all artifacts and key decisions specifically
- 🚫 Do not overwrite existing entries
@ -57,7 +57,7 @@ Document Phase 2: Trigger Mapping completion in the project design log, listing
### 1. Read Current Log
Read `{output_folder}/_progress/00-progress.md` to understand existing entries and format.
Read `{output_folder}/_progress/00-design-log.md` to understand existing entries and format.
### 2. Append Progress Entry
@ -106,7 +106,7 @@ If no significant decisions were made, skip this section.
- Summary is specific, not generic
- Key decisions recorded (if any)
Output: "Design log updated. Phase 2: Trigger Mapping documented in _progress/00-progress.md"
Output: "Design log updated. Phase 2: Trigger Mapping documented in _progress/00-design-log.md"
### 5. Present MENU OPTIONS

View File

@ -55,7 +55,7 @@ Document Phase 3 completion in the project design log, recording all artifacts c
### 1. Read the Current Log
Read `{output_folder}/_progress/00-progress.md` to understand existing entries and format.
Read `{output_folder}/_progress/00-design-log.md` to understand existing entries and format.
### 2. Append Progress Entry

View File

@ -393,7 +393,7 @@ white cards with subtle shadow, warm authentic imagery.
- **Only content swaps:** image descriptions, headlines, service lists, section-specific text
- **Sequential generation:** Generate one at a time, quick-review each, flag outliers for iteration
- **Use `flash` model tier** for batch runs (faster, cheaper) — save `pro` for the template page
- **Track everything** in the batch agent dialog for reproducibility
- **Track everything** in the agent experience file for reproducibility
---

View File

@ -104,7 +104,7 @@ Now they're on [page name].
**If the user decides to eliminate the step:**
1. Update the scenario outline (remove/merge the step)
2. Remove the page folder
3. Append status `removed` to `{output_folder}/_progress/00-progress.md` Design Loop Status table:
3. Append status `removed` to `{output_folder}/_progress/00-design-log.md` Design Loop Status table:
`| [Scenario slug] | [NN.X] | [Page name] | removed | [YYYY-MM-DD] |`
4. Loop back to step 2 (Set the Scene) for the next page
@ -136,7 +136,7 @@ When the discussion feels complete, summarize:
</output>
<action>Update the page specification with discussion findings (fill empty sections in the existing page spec file)</action>
<action>Update design log: append row with status `discussed` to `{output_folder}/_progress/00-progress.md` (see section 9 for exact format)</action>
<action>Update design log: append row with status `discussed` to `{output_folder}/_progress/00-design-log.md` (see section 9 for exact format)</action>
### 7. Visualization Question
@ -173,7 +173,7 @@ Let me know when you've saved the image.
<action>Wait for user confirmation that the PNG is saved.</action>
<action>SYNC SPEC: Update the page specification to match the agreed wireframe. Add a reference to the PNG in the spec's visual reference section. The spec is the source of truth — never implement from wireframe directly.</action>
<action>Update design log: append row with status `wireframed` to `{output_folder}/_progress/00-progress.md` (see section 9)</action>
<action>Update design log: append row with status `wireframed` to `{output_folder}/_progress/00-design-log.md` (see section 9)</action>
<output>See `{designLoopGuide}` for the full design loop reference.</output>
Then proceed to the **Page Transition** (step 8).
@ -187,7 +187,7 @@ Then proceed to the **Page Transition** (step 8).
#### IF 3 (Specification without sketch):
<action>Proceed to specification activity (steps-p/) with the discussion findings</action>
<action>Update design log: append row with status `specified` to `{output_folder}/_progress/00-progress.md` (see section 9)</action>
<action>Update design log: append row with status `specified` to `{output_folder}/_progress/00-design-log.md` (see section 9)</action>
Then proceed to the **Page Transition** (step 8).
@ -244,22 +244,22 @@ If none exist (simple page, single-device platform):
- **Next logical step:** Proceed to the appropriate activity (specification → steps-p/, responsive → diff file, build → Phase 5 prototyping)
- **Explore next scenario step:** Loop back to step 2 (Set the Scene) for the next page in the scenario's shortest path. If no more pages, show "All pages in this scenario are designed!"
- **Design log:** Always append a status row to `{output_folder}/_progress/00-progress.md` before presenting transition options (see section 9)
- **Session plan:** Check off the completed item in the active agent dialog. If all plan items are done, note it in the transition: "That's everything we planned! Want to continue or wrap up?"
- **Design log:** Always append a status row to `{output_folder}/_progress/00-design-log.md` before presenting transition options (see section 9)
- **Current task:** Update the Current table in the design log — remove completed task, add next task if continuing
#### EXECUTION RULES:
- ALWAYS halt and wait for user input after presenting transition options
- User can chat or ask questions — always respond and then redisplay the transition
- The user can always say "stop" to pause and return later — update the design log with current status AND set the agent dialog to `status: paused`
- The user can always say "stop" to pause and return later — update the design log with current status and clear the Current table
### 9. Design Log Updates
At every transition, append a row to the **Design Loop Status** table in `{output_folder}/_progress/00-progress.md`.
At every transition, append a row to the **Design Loop Status** table in `{output_folder}/_progress/00-design-log.md`.
**How to update (exact procedure):**
1. Open `{output_folder}/_progress/00-progress.md`
1. Open `{output_folder}/_progress/00-design-log.md`
2. Find the `## Design Loop Status` section
3. Append a new row to the table:

View File

@ -99,7 +99,7 @@ Fill in all sections with data collected:
### 2. Update Design Log
<action>Append a row with status `specified` to the Design Loop Status table in `{output_folder}/_progress/00-progress.md`:
<action>Append a row with status `specified` to the Design Loop Status table in `{output_folder}/_progress/00-design-log.md`:
```
| [Scenario slug] | [NN.X] | [Page name] | specified | [YYYY-MM-DD] |

View File

@ -82,8 +82,7 @@ How would you like to create the visual design?
### 3. Setup Gate (Nano Banana only)
If user selects [N]:
1. Check for existing agent dialog for this page in `{output_folder}/_progress/agent-dialogs/`
- If active dialog found: offer to resume previous visual generation session
1. Check the design log at `{output_folder}/_progress/00-design-log.md` for previous visual generation entries for this page
2. If first time using Nano Banana in this project:
- Route to `step-00-nb-setup.md` to verify MCP connection
- Return here after verification succeeds

View File

@ -39,12 +39,12 @@ Translate a page specification into an effective AI image generation prompt that
- 🎯 Focus on composing an effective generation prompt from page spec data
- 🚫 FORBIDDEN to generate without user confirming creative direction
- 💬 Approach: Extract, present, let user override, compose, generate, iterate
- 📋 Track all generations in agent dialog file
- 📋 Track all generations in agent experience file
## EXECUTION PROTOCOLS:
- 🎯 Extract image descriptions, gather creative direction, compose prompt, generate
- 💾 Log all generations to agent dialog file
- 💾 Log all generations to agent experience file
- 📖 Reference NANO-BANANA-PROMPT-GUIDE.md for compression strategy
- 🚫 FORBIDDEN to skip creative direction step
@ -57,24 +57,15 @@ Translate a page specification into an effective AI image generation prompt that
## Sequence of Instructions (Do not deviate, skip, or optimize)
### 0. Start Agent Dialog
### 0. Start Generation Log
Create (or resume) an agent dialog file to track this visual generation session.
Create an agent experience file to track this visual generation session.
**File location:** `{output_folder}/_progress/agent-dialogs/`
**Naming:** `{date}-freya-visual-{page-name}.md`
**Example:** `2026-02-19-freya-visual-1.1-hem.md`
**File location:** `{output_folder}/_progress/agent-experiences/`
**Naming:** `{date}-visual-{page-name}.md`
**Example:** `2026-02-19-visual-1.1-hem.md`
```markdown
---
status: active
agent: Freya
topic: Visual generation for {page-name}
created: {timestamp}
last_updated: {timestamp}
context_summary: Generating visual designs for {page-name} using Nano Banana
---
# Visual Generation: {page-name}
## Inputs
@ -92,7 +83,7 @@ context_summary: Generating visual designs for {page-name} using Nano Banana
{each generation appended here in step H}
```
**If an active dialog exists** for this page, resume it -- load previous context, creative direction, and generation history.
**If a previous generation log exists** for this page, read it for context — previous creative direction, successful prompts, and lessons learned.
### A. Load Inputs
@ -253,7 +244,7 @@ Call `mcp__nanobanana__generate_image` with the assembled prompt, system instruc
Present the result to the user.
**Log to agent dialog:**
**Log to agent experience file:**
```markdown
### Generation {N} -- {timestamp}
@ -274,7 +265,7 @@ Present the result to the user.
**User feedback:** {filled after review}
```
Update the dialog `last_updated` timestamp.
Update the agent experience file.
### I. Iterate
@ -339,19 +330,19 @@ ONLY WHEN the user has accepted a generated visual and selected an option from t
### ✅ SUCCESS:
- Agent dialog created or resumed
- Generation log created in agent experiences
- Image descriptions extracted from spec
- User creative direction captured
- Prompt composed within 8192 char limit
- Image generated and presented
- Generation logged to agent dialog
- Generation logged to agent experience file
- User accepted or iterated to satisfaction
### ❌ SYSTEM FAILURE:
- Generating without user creative direction
- Exceeding prompt character limit
- Not logging generations to agent dialog
- Not logging generations to agent experience file
- Not presenting iteration options
- Skipping reference image auto-detection

View File

@ -87,7 +87,7 @@ Store visual artifact in the appropriate location:
- **Image assets (photos/illustrations):** `{output_folder}/D-Design-System/01-Visual-Design/design-concepts/` (move to `02-Assets/images/` when finalized)
- **Legacy path:** `{output_folder}/C-UX-Scenarios/[scenario]/visuals/` (if project uses older folder structure)
**Update the agent dialog** with the accepted result and save path.
**Update the agent experience file** with the accepted result and save path.
### 5. Present MENU OPTIONS
@ -117,14 +117,14 @@ ONLY WHEN the user selects an option from the menu and the visual has been integ
- Design decisions documented
- Page specification updated with visual reference
- Visual artifact saved to correct location
- Agent dialog updated with accepted result
- Agent experience file updated with accepted result
### ❌ SYSTEM FAILURE:
- Skipping user feedback
- Not integrating into page specification
- Not saving visual artifact
- Not updating agent dialog
- Not updating agent experience file
- Relying on AI-generated text in images for content accuracy
**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

View File

@ -13,12 +13,7 @@ description: 'Creative dialog for page design — discuss what each page needs,
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
## Entry

View File

@ -13,12 +13,7 @@ description: 'Define, update, and review design system components used across pa
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
## Extraction Rules
@ -60,6 +55,6 @@ Execute steps in `./steps-m/`:
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Design System: [components extracted/updated]`
2. Suggest next action based on the adaptive dashboard

View File

@ -13,12 +13,7 @@ description: 'The agent creates a complete scenario flow autonomously, then pres
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
## Entry
@ -67,7 +62,7 @@ In Dream mode:
- **OVERRIDE** all "halt and wait" rules — auto-proceed after completing each step
- **OVERRIDE** "NEVER generate content without user input" — generate based on context and WDS patterns
- **DO NOT** display menus or wait for menu selections between steps
- **DO** still save outputs and update agent dialog at each step
- **DO** still save outputs and update the design log at each step
- **DO** still follow the step's actual instructions for what to generate
- The user can type **"stop"** or **"pause"** at any time to interrupt and switch to Suggest mode
@ -79,7 +74,7 @@ In Dream mode:
## DESIGN LOG REPORTING
In Dream mode, the agent updates the design log autonomously at each page completion. Append to the Design Loop Status table in `{output_folder}/_progress/00-progress.md`:
In Dream mode, the agent updates the design log autonomously at each page completion. Append to the Design Loop Status table in `{output_folder}/_progress/00-design-log.md`:
```
| [Scenario slug] | [NN.X] | [Page name] | specified | [YYYY-MM-DD] |

View File

@ -13,11 +13,7 @@ description: Package complete testable flows and hand off to development
## INITIALIZATION
### Agent Dialog Gate
1. Check `{output_folder}/_progress/agent-dialogs/` for pending handover dialogs
2. If none exists, suggest creating one for this handover
3. If exists, load and resume
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
---
@ -43,6 +39,6 @@ Execute steps in `./steps-h/`:
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Design Delivery: [what was packaged]`
2. Suggest next action: Phase 5 prototyping or next scenario

View File

@ -13,12 +13,7 @@ description: 'Analyze user-provided sketches (photos, screenshots, wireframes) a
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
## Entry

View File

@ -13,12 +13,7 @@ description: 'Create a complete, implementation-ready page specification with la
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
## Entry

View File

@ -13,12 +13,7 @@ description: 'Build a scenario's page flow step by step, with the agent proposin
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
## Entry
@ -73,7 +68,7 @@ Execute steps in `./steps-s/`:
### Design Log Update
After finishing a page specification, append to the Design Loop Status table in `{output_folder}/_progress/00-progress.md`:
After finishing a page specification, append to the Design Loop Status table in `{output_folder}/_progress/00-design-log.md`:
```
| [Scenario slug] | [NN.X] | [Page name] | specified | [YYYY-MM-DD] |
```

View File

@ -13,11 +13,7 @@ description: 'Systematically audit page specifications for completeness, consist
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
### Configuration Loading
@ -59,6 +55,6 @@ Save validation report to `{output_folder}/_progress/validation-report.md`
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Validation: [N] pages audited, [results summary]`
2. If issues found, suggest fixing them. If all pass, suggest next logical step from the adaptive dashboard

View File

@ -13,12 +13,7 @@ description: 'Create visual representations of page designs using external tools
## INITIALIZATION
### Agent Dialog Gate
1. Check for pending activity dialogs
2. If none, suggest creating one
3. Load dialog context
Read design log at `{output_folder}/_progress/00-design-log.md` before starting.
## Entry
@ -49,6 +44,6 @@ Execute steps in `./steps-w/`:
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Visual Design: [what was generated]`
2. Suggest next action based on the adaptive dashboard (read Design Loop Status to find what needs attention next)

View File

@ -40,13 +40,15 @@ Load and read full config from `{project-root}/_bmad/wds/config.yaml` and resolv
- `project_name`, `output_folder`, `user_name`
- `communication_language`, `document_output_language`
### 2. Agent Dialog Gate
### 2. Design Log Loading
Check `{output_folder}/_progress/agent-dialogs/` for agent dialogs with `status: active` and `agent: Freya`.
Read the design log at `{output_folder}/_progress/00-design-log.md`. This single file contains:
- **Backlog** — business-value items to work on
- **Current** — what's actively being worked on right now
- **Design Loop Status** — per-page status tracking (latest row per page = current status)
- **Log** — append-only history of completed work
**If an active dialog exists:** Read it. The dialog contains the session plan — what pages the user intended to work on and how far they got. Use this to drive the dashboard.
**If no active dialog exists:** You'll create one after the user chooses what to work on (see step 4c).
If the file doesn't exist, guide the user to run Phase 0 setup first.
### 3. Mode Determination
@ -56,48 +58,53 @@ Check `{output_folder}/_progress/agent-dialogs/` for agent dialogs with `status:
### 4. Adaptive Dashboard
Read both sources:
1. **Agent dialog** (the plan) — what was the user working on?
2. **Design log** (`{output_folder}/_progress/00-progress.md`) — what status did each page reach?
3. **Scenario files** from `{output_folder}/C-UX-Scenarios/` — full page inventory
Read from the design log and scenario files:
1. **Design log** (`{output_folder}/_progress/00-design-log.md`) — Backlog, Current, Design Loop Status, Log
2. **Scenario files** from `{output_folder}/C-UX-Scenarios/` — full page inventory
#### 4a. Build Status Overview
For each scenario, determine per-page status from the Design Loop Status table in the design log. The **latest row per page** is the current status.
For each scenario, determine per-page status from the **Design Loop Status** table. The latest row per page is the current status.
Check the **Current** table — if a task is listed there, the user was mid-work when the last session ended.
#### 4b. Suggest Where to Continue
**If an active dialog with a session plan exists:**
Read the plan's checklist. Compare against the design log. Present what's done and what's left:
**If a task is listed in Current:**
<output>
**Welcome back! Here's where we left off:**
**Session plan:** [topic from dialog]
**In progress:** [task from Current table]
| Step | Page | Plan | Status |
|------|------|------|--------|
| [NN.1] | [page name] | [target] | [current] ✓ |
| [NN.2] | [page name] | [target] | [current] ← next |
| [NN.3] | [page name] | [target] | — |
**Design status:**
| Scenario | Page | Status |
|----------|------|--------|
| [NN] | [page name] | [current status] |
| ... | ... | ... |
I'd suggest we continue with **[next unchecked item from the plan]**.
Pick up there, or change plans?
I'd suggest we continue with **[the in-progress task]**.
Pick up there, or change direction?
</output>
**If the session plan is complete** (all items checked):
**If Current is empty but Backlog has items:**
<output>
**Session plan complete!**
**Ready to continue!**
Everything we planned is done. What would you like to do next?
**Next from backlog:**
- [ ] [first unchecked backlog item]
- [ ] [second unchecked backlog item]
1. **Continue with [next scenario step / next scenario]** — keep the momentum
2. **Start a new session plan** — pick different pages to work on
**Design status:**
| Scenario | Page | Status |
|----------|------|--------|
| [NN] | [page name] | [latest status] |
I'd suggest we start with **[first backlog item]**. Sound good?
</output>
**If no active dialog exists** (fresh start):
**If both Current and Backlog are empty** (fresh project):
<output>
**Ready to start designing!**
@ -108,44 +115,22 @@ Your scenarios:
| 01 | [Name] | [total] | [done] |
| 02 | [Name] | [total] | [done] |
Which scenario shall we work on? I'll set up a session plan.
Which scenario shall we work on?
</output>
#### 4c. Create or Update Session Plan
#### 4c. Design Log Updates
**When starting a new session**, create an agent dialog file:
**When starting work:** Move the task from Backlog to Current (or add a new row to Current).
**File:** `{output_folder}/_progress/agent-dialogs/YYYY-MM-DD-freya-[topic].md`
**At each transition:** Append a row to the Design Loop Status table with the new status. Update the Log section with what was accomplished.
```markdown
---
status: active
agent: Freya
topic: [what the user wants to work on]
created: [date]
last_updated: [date]
---
**When finishing a task:** Remove from Current. Check off the Backlog item if applicable. The next session reads the updated design log and knows exactly where things stand.
# [Topic]
#### 4d. Agent Experiences
## Session Plan
After fruitful design discussions, methodology breakthroughs, or pattern discoveries, save compressed insights to `{output_folder}/_progress/agent-experiences/YYYY-MM-DD-[topic].md`. These are cross-session wisdom — not project state, but lessons learned.
| # | Page | Target Status | Done |
|---|------|---------------|------|
| 1 | [NN.X page name] | [discussed/wireframed/specified/etc.] | [ ] |
| 2 | [NN.X page name] | [discussed/wireframed/specified/etc.] | [ ] |
## Decisions Made
| # | Decision | Rationale |
|---|----------|-----------|
```
**At each transition:** Update the dialog — check off completed items, add decisions, update `last_updated`.
**When the plan is complete or user stops:** Set `status: complete` or `status: paused`. The next session will find no active dialog and offer to start fresh or resume.
#### 4d. User Response Handling
#### 4e. User Response Handling
- **User accepts suggestion** → Load the appropriate activity workflow and continue
- **User picks a different page or scenario** → Update the session plan and continue

View File

@ -42,7 +42,7 @@ Execute steps in `./steps-t/`:
## DESIGN LOG REPORTING POINT
When all tests pass and the user approves, append to the Design Loop Status table in `{output_folder}/_progress/00-progress.md`:
When all tests pass and the user approves, append to the Design Loop Status table in `{output_folder}/_progress/00-design-log.md`:
```
| [Scenario slug] | [NN.X] | [Page name] | approved | [YYYY-MM-DD] |

View File

@ -59,6 +59,6 @@ Execute steps in `./steps-a/`:
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Analysis: [what was analyzed, key findings]`
2. Suggest next action: feed into development, reverse engineer further, or start prototyping

View File

@ -62,6 +62,6 @@ Execute steps in `./steps-f/`:
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Bugfix: [what was fixed]`
2. Suggest re-running acceptance testing (Phase 5 [T]) to verify the fix

View File

@ -75,7 +75,7 @@ Execute steps in `./steps-d/`:
## DESIGN LOG REPORTING POINTS
Append to the Design Loop Status table in `{output_folder}/_progress/00-progress.md`:
Append to the Design Loop Status table in `{output_folder}/_progress/00-design-log.md`:
**On entry (step 01 complete):** `| [Scenario slug] | [NN.X] | [Page name] | building | [YYYY-MM-DD] |`
**On completion (step 05 approved):** `| [Scenario slug] | [NN.X] | [Page name] | built | [YYYY-MM-DD] |`

View File

@ -62,6 +62,6 @@ Execute steps in `./steps-e/`:
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Evolution: [what was evolved/added]`
2. Suggest acceptance testing (Phase 5 [T]) to validate the changes

View File

@ -61,7 +61,7 @@ Execute steps in `./steps-p/`:
## DESIGN LOG REPORTING POINTS
This workflow has TWO reporting points. Both append to the Design Loop Status table in `{output_folder}/_progress/00-progress.md`:
This workflow has TWO reporting points. Both append to the Design Loop Status table in `{output_folder}/_progress/00-design-log.md`:
**1. On entry (step 1 complete):** Append status `building`
```

View File

@ -63,6 +63,6 @@ Execute steps in `./steps-r/`:
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-progress.md` under `## Progress`:
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Reverse Engineering: [what was extracted]`
2. Suggest next action: feed specs into prototyping, analyze further, or start development

View File

@ -302,7 +302,7 @@ class Installer {
// Create _progress folder for agent tracking
const progressPath = path.join(docsPath, '_progress');
await fs.ensureDir(progressPath);
await fs.ensureDir(path.join(progressPath, 'agent-dialogs'));
await fs.ensureDir(path.join(progressPath, 'agent-experiences'));
}
}