whiteport-design-studio 0.2.2 → 0.3.0

package/src/workflows/_agent-dialogs/steps/step-04-execute-steps.md

@@ -1,250 +0,0 @@
-# Step 4: Execute Steps
-
-## CONTEXT
-
-Step files are created. Now we execute each step, either in this dialog or in fresh agent dialogs.
-
-**Note:** For implementation-specific execution details (feedback protocol, dynamic planning), see the **Agentic Development Workflow** in `workflows/4-ux-design/agentic-development/workflow.md`.
-
----
-
-## EXECUTION MODES
-
-### Mode A: Continuous Execution
-Execute all steps in the current session.
-- ✅ Good for: Small implementations, full context available
-- ❌ Risk: Context window limits, fatigue
-
-### Mode B: Fresh Dialog Per Step
-Start a new agent dialog for each step.
-- ✅ Good for: Large implementations, complex steps
-- ✅ Benefit: Fresh context, isolated focus
-- ❌ Requires: Well-written self-contained step files
-
-<ask>**Which execution mode?**
-
-[A] Continuous — Execute steps in this session
-[B] Fresh dialogs — I'll execute each step in a new dialog
-
-Mode:</ask>
-
----
-
-## MODE A: CONTINUOUS EXECUTION
-
-### Execute Current Step
-
-<action>
-1. **Read the step file** completely
-2. **Document any decisions or issues** in the dialog before implementing
-3. **Execute the implementation** following the instructions
-4. **Add sub-steps** if needed for things discovered during implementation
-5. **Verify against acceptance criteria**
-6. **Test using the test instructions**
-</action>
-
-### Step Completion Checklist
-
-- [ ] All objectives achieved
-- [ ] Acceptance criteria pass
-- [ ] Tests pass
-- [ ] No TypeScript errors
-- [ ] Code follows existing patterns
-
-### Update Dialog File
-
-<action>
-**After completing each step:**
-
-1. Update step status: 🔲 → ✅
-2. Add notes if relevant
-3. Add entry to Progress Log:
-   ```
-   ### {today's date}
-   - Completed Step {N}: {step name}
-   - {any notes or discoveries}
-   ```
-</action>
-
-### Continue or Pause
-
-<ask>**Step complete! What's next?**
-
-[A] Continue to next step
-[B] Pause — save progress and continue later
-[C] Review what was done
-
-Choice:</ask>
-
-<check if="choice == A">
-  <action>
-  1. Review and update remaining steps in dialog file
-  2. Load and execute next step file
-  </action>
-</check>
-
-<check if="choice == B">
-  <action>
-  Update dialog file:
-  - Status: "In Progress"
-  - Progress Log: Note where we stopped
-  - Ensure all decisions documented
-
-  Output: "Progress saved. The dialog is ready to resume."
-  </action>
-</check>
-
----
-
-## MODE B: FRESH DIALOG INSTRUCTIONS
-
-### Handoff Always References Dialog
-
-<warning>
-**Any handoff — to a new session, new agent, or human — MUST reference the dialog document.**
-
-The dialog document is the single source of truth for:
-- What has been done
-- What decisions were made
-- What remains to be done
-- Any issues or blockers
-
-Never hand off by describing the task verbally. Always point to the dialog.
-</warning>
-
-### For Each Step
-
-<action>
-**Generate handoff instructions:**
-
-```
-## Execute Step {N}: {Step Name}
-
-### Dialog Document (READ FIRST)
-`{output_folder}/_progress/agent-dialogs/{date}-{feature-name}/{date}-{feature-name}-dialog.md`
-
-Read the dialog file first to understand:
-- Overall context and scope
-- What steps are complete
-- Current status and any blockers
-
-### Step File
-`{output_folder}/_progress/agent-dialogs/{date}-{feature-name}/steps/{N}-{step-name}.md`
-
-### Instructions
-1. Read the dialog file completely
-2. Read the step file
-3. Execute the implementation
-4. Document decisions in the dialog BEFORE implementing
-5. Verify against acceptance criteria
-6. Update dialog file: step status → ✅, add Progress Log entry
-```
-</action>
-
-### Track Progress
-
-<ask>**Step {N} — What's the status?**
-
-[A] ✅ Complete — Move to next step
-[B] 🔄 In Progress — Still working
-[C] ⏸️ Blocked — Cannot proceed
-[D] ❌ Skip — Will not implement
-
-Status:</ask>
-
-<action>Update dialog file with reported status</action>
-
----
-
-## HANDLING ISSUES
-
-### If Implementation Differs from Spec
-
-<action>
-Document in the dialog file's "Spec Changes Discovered" section:
-
-| Issue | Resolution | Spec Updated? |
-|-------|------------|---------------|
-| {issue} | {how resolved} | 🔲 |
-</action>
-
-### If Step is Too Complex
-
-<action>
-Options:
-1. Break into sub-steps (create additional step files)
-2. Simplify scope (update dialog file)
-3. Seek clarification (document blocker)
-</action>
-
-### If Blocked on Dependencies
-
-<action>
-1. Update step status: ⏸️ Blocked
-2. Document the blocker in Notes
-3. Move to next step if possible
-4. Return to blocked step later
-</action>
-
----
-
-## PROGRESS TRACKING
-
-### After Each Step
-
-<action>
-Update the Steps Overview table:
-
-| # | Step | Status | Notes |
-|---|------|--------|-------|
-| 1 | Step name | ✅ | Completed |
-| 2 | Step name | ✅ | Completed with minor changes |
-| 3 | Step name | 🔄 | In progress |
-| 4 | Step name | 🔲 | Not started |
-</action>
-
-### Progress Log Entry
-
-<action>
-Add to Progress Log:
-
-```markdown
-### {YYYY-MM-DD}
-- Completed Step 1: {description}
-- Completed Step 2: {description}
-- Started Step 3
-- Discovered: {any issues or learnings}
-```
-</action>
-
----
-
-## ALL STEPS COMPLETE
-
-<check if="all_steps_complete">
-  <output>
-  **All steps complete!**
-
-  Proceed to Step 5 to finalize the dialog.
-
-  [A] Continue to Step 5: Complete Dialog
-  [B] Review the implementation first
-
-  Choice:
-  </output>
-</check>
-
----
-
-## ROUTING
-
-<action>
-Based on completion:
-- All steps done → Load step-05-complete-dialog.md
-- Steps remaining → Continue execution loop
-- User pauses → Save state and exit
-</action>
-
----
-
-_Agent Dialog Workflow — Step 4: Execute Steps_

package/src/workflows/_agent-dialogs/steps/step-05-complete-dialog.md

@@ -1,177 +0,0 @@
-# Step 5: Complete Dialog
-
-## CONTEXT
-
-All implementation steps are complete. Now we finalize the dialog, capture learnings, and close it out.
-
----
-
-## VERIFY COMPLETION
-
-<action>
-**Review the Steps Overview table:**
-
-Confirm all steps have status:
-- ✅ Complete
-- ❌ Skipped (with documented reason)
-
-No steps should be:
-- 🔲 Not Started
-- 🔄 In Progress
-- ⏸️ Blocked
-</action>
-
-<check if="incomplete_steps_exist">
-  <ask>**Some steps are not complete:**
-
-  {{#each step in incomplete_steps}}
-  - Step {{step.number}}: {{step.name}} — {{step.status}}
-  {{/each}}
-
-  How should we proceed?
-
-  [A] Complete remaining steps first
-  [B] Mark as skipped and continue
-  [C] Leave dialog "In Progress"
-
-  Choice:</ask>
-</check>
-
----
-
-## UPDATE SPEC CHANGES
-
-<action>
-**Review "Spec Changes Discovered" section:**
-
-For each discovered issue:
-1. Determine if spec should be updated
-2. If yes, create a note or task to update the spec
-3. Mark the spec update status
-</action>
-
-<ask>**Were any specification changes discovered?**
-
-[A] Yes — Review and document updates needed
-[B] No — No spec changes needed
-
-Choice:</ask>
-
-<check if="choice == A">
-  <action>
-  Update the dialog file:
-
-  | Issue | Resolution | Spec Updated? |
-  |-------|------------|---------------|
-  {{#each change in spec_changes}}
-  | {{change.issue}} | {{change.resolution}} | {{change.updated}} |
-  {{/each}}
-
-  If specs need updating, either:
-  1. Update them now
-  2. Create a task/dialog to update them later
-  </action>
-</check>
-
----
-
-## CAPTURE LEARNINGS
-
-<ask>**What did we learn from this implementation?**
-
-Consider:
-- What worked well?
-- What was harder than expected?
-- What patterns emerged?
-- What would you do differently?
-
-Learnings:</ask>
-
-<action>
-Add to the Learnings section:
-
-{{#each learning in learnings}}
-- {{learning}}
-{{/each}}
-</action>
-
----
-
-## FINAL PROGRESS LOG ENTRY
-
-<action>
-Add final entry to Progress Log:
-
-```markdown
-### {YYYY-MM-DD} — COMPLETED
-- All steps complete
-- Spec changes: {summary}
-- Learnings captured
-- Dialog closed
-```
-</action>
-
----
-
-## UPDATE FINAL STATUS
-
-<action>
-Update the Meta section:
-
-| Field | Value |
-|-------|-------|
-| **Status** | **Complete** |
-</action>
-
----
-
-## SUMMARY
-
-<output>
-✅ **Dialog Complete!**
-
-**Feature:** {feature_name}
-**Date Started:** {start_date}
-**Date Completed:** {today}
-
-**Steps Completed:** {completed_count} / {total_count}
-**Spec Changes:** {spec_changes_count}
-**Learnings:** {learnings_count}
-
----
-
-**The dialog is now closed.**
-
-The folder remains at:
-`{output_folder}/_progress/agent-dialogs/{date}-{feature_slug}/`
-
-This serves as documentation of:
-- What was implemented
-- How it was done
-- What was learned
-
----
-
-**What's next?**
-
-[A] Start a new dialog for related work
-[B] Return to main menu
-[C] Review the completed dialog
-
-Choice:
-</output>
-
----
-
-## ROUTING
-
-<action>
-Based on user choice:
-- [A] → Return to step-01-initialize-dialog.md
-- [B] → End workflow
-- [C] → Display dialog file contents
-</action>
-
----
-
-_Agent Dialog Workflow — Step 5: Complete Dialog_

package/src/workflows/_agent-dialogs/templates/agent-dialog.template.md

@@ -1,115 +0,0 @@
-# {{workflow_name}}: {{project_name}}
-
-**Workflow:** {{workflow_phase}}
-**Project:** {{project_name}}
-**Date:** {{date}}
-**Status:** in_progress
-**Agent:** {{agent_name}}
-**Session:** 1
-
----
-
-## Context
-
-{{context_description}}
-
-**Preceded by:** {{previous_phase_or_none}}
-**Objectives:** {{workflow_objectives}}
-
----
-
-## Plan
-
-**Real-time progress tracking with visual status indicators**
-
-1. ⏳ **{{step_1}}** — {{description}}
-2. ⏸ **{{step_2}}** — {{description}}
-3. ⏸ **{{step_3}}** — {{description}}
-4. ⏸ **{{step_4}}** — {{description}}
-5. ⏸ **Wrap Up & Retrospective** — Assess success, document learnings, prepare handoff
-
-**Status Indicators:**
-- ⏳ **In Progress** — Currently working on this
-- ✅ **Complete** — Finished successfully
-- ⚠️ **Partial/Issues** — Done but with caveats or blockers
-- ⏸ **Pending** — Not started yet
-
-**CRITICAL:** Only ONE task should be "In Progress" (⏳) at a time. Update status immediately upon completion.
-
----
-
-## Session Transcript
-
-### {{topic_1}}
-**Q:** {{question}}
-**A:** {{answer}}
-**Documented in:** {{files_updated}}
-**Timestamp:** {{time}}
-
-### {{topic_2}}
-**Q:** {{question}}
-**A:** {{answer}}
-**Documented in:** {{files_updated}}
-**Decision:** {{key_decision_if_applicable}}
-**Timestamp:** {{time}}
-
----
-
-## Key Decisions
-
-- **{{decision_1}}:** {{what_decided}} — {{rationale}}
-- **{{decision_2}}:** {{what_decided}} — {{rationale}}
-
----
-
-## Generated Artifacts
-
-- [x] [{{file_1}}](../{{relative_path}}) — {{description}}
-- [ ] [{{file_2}}](../{{relative_path}}) — {{description}}
-
----
-
-## Blockers / Issues
-
-{{blockers_or_none}}
-
----
-
-## Wrap Up & Retrospective
-
-**COMPLETE BEFORE MARKING WORKFLOW AS "COMPLETE"**
-
-### Success Criteria Assessment
-{{evaluate_against_original_objectives}}
-
-### What Worked Well
-1. {{thing_that_worked_1}}
-2. {{thing_that_worked_2}}
-3. {{thing_that_worked_3}}
-
-### What Didn't Work / Issues Encountered
-1. **{{issue_1}}:** {{description}} — {{fix_or_workaround}}
-2. **{{issue_2}}:** {{description}} — {{fix_or_workaround}}
-
-### Process Improvements Needed
-1. **{{gap_1}}:** {{description}} — {{recommendation}}
-2. **{{gap_2}}:** {{description}} — {{recommendation}}
-
-### User Feedback
-**[User: Please add your feedback here]**
-
-**Quality:** {{how_was_output_quality}}
-
-**Process:** {{how_did_collaboration_feel}}
-
-**Gaps:** {{what_was_missing}}
-
-**Suggestions:** {{what_should_improve}}
-
-### Handoff Notes
-{{critical_information_for_next_phase}}
-
----
-
-**Status:** in_progress
-**Last Updated:** {{date}} {{time}}

package/src/workflows/_agent-dialogs/templates/dialog-capture.template.md

@@ -1,75 +0,0 @@
-# {DATE} {Feature Name} — Capture
-
-## Meta
-
-| Field | Value |
-|-------|-------|
-| **Date** | {YYYY-MM-DD} |
-| **Type** | 💾 Capture |
-| **Agent** | {Agent name} |
-| **Feature** | {Feature name} |
-| **Specification** | [{Spec name}]({path-to-spec}) |
-| **Status** | Not Started |
-
----
-
-## Purpose
-
-{1-3 sentences describing what this dialog will accomplish}
-
----
-
-## Captured Thoughts
-
-{Capture your thinking while it's fresh:}
-
-### The Idea
-
-{What do you want to build/change/fix?}
-
-### Why
-
-{Why is this needed? What problem does it solve?}
-
-### Rough Approach
-
-{Any initial thoughts on how to approach this?}
-
-### Notes
-
-{Anything else to remember}
-
----
-
-## Context for Next Agent
-
-{Help the agent that continues this work:}
-
-### Current Thinking
-
-{What's your current understanding or hypothesis?}
-
-### Open Questions
-
-{What questions should be explored or clarified?}
-
-### Concerns
-
-{Any potential issues, risks, or things to watch out for?}
-
-### Suggestions
-
-{Any specific approaches or patterns you'd recommend?}
-
----
-
-## When I Return
-
-1. Read the specification: {spec_path}
-2. Complete Setup Context section
-3. Analyze scope and create steps
-4. Start implementing
-
----
-
-_Capture Agent Dialog — to be expanded later_