diff options
| author | Craig Jennings <c@cjennings.net> | 2026-02-07 21:41:19 -0600 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-02-07 21:41:19 -0600 |
| commit | 6787fb160c80118b80df37c01cb69dcfbebfff17 (patch) | |
| tree | e5b43c8c62e027b7cabffa31b43238027ec284d0 /docs/workflows/retrospective-workflow.org | |
| parent | cad8146f1bfe6224ad476f33e3087b2e2074c717 (diff) | |
| download | archangel-6787fb160c80118b80df37c01cb69dcfbebfff17.tar.gz archangel-6787fb160c80118b80df37c01cb69dcfbebfff17.zip | |
docs: sync templates, rename workflows and notes.org
Sync from templates. Rename NOTES.org to notes.org,
session-wrap-up to wrap-it-up, retrospective-workflow to
retrospective, session-start to startup. Update all references.
Diffstat (limited to 'docs/workflows/retrospective-workflow.org')
| -rw-r--r-- | docs/workflows/retrospective-workflow.org | 90 |
1 files changed, 0 insertions, 90 deletions
diff --git a/docs/workflows/retrospective-workflow.org b/docs/workflows/retrospective-workflow.org deleted file mode 100644 index 440c14e..0000000 --- a/docs/workflows/retrospective-workflow.org +++ /dev/null @@ -1,90 +0,0 @@ -#+TITLE: Retrospective Workflow -#+DESCRIPTION: How to run a retrospective after major problem-solving sessions - -* When to Run a Retrospective - -Run after: -- Major debugging/troubleshooting sessions -- Complex multi-step implementations -- Any session where significant friction occurred -- Sessions lasting more than an hour with trial-and-error - -* The Process - -** 1. Trigger the Retrospective - -Either party can say: "Let's do a retrospective" or "Retrospective time" - -** 2. Answer These Questions (Both Parties) - -*** What went well? -Identify patterns worth reinforcing. Be specific. - -*** What didn't go well? -Identify friction points, mistakes, wasted time. No blame, just facts. - -*** What behavioral changes should we make? -Focus on *how we work*, not technical facts. -- Good: "Confirm before rebooting" -- Not behavioral: "AMD needs firmware 20260110" - -*** What would we do differently next time? -Specific scenarios and better approaches. - -*** Any new principles to add? -Distill lessons into short, actionable principles for retrospective/PRINCIPLES.org. - -** 3. Copy and Update retrospectives/PRINCIPLES.org - -Copy the template retrospectives/PRINCIPLES.org. - -Using the copied template, add new behavioral principles learned. Keep them: -- Short and actionable -- Focused on behavior, not facts -- Easy to remember and apply - -** 4. Create Retrospective Record - -Save to =docs/retrospectives/YYYY-MM-DD-topic.org= with: -- Summary of what happened -- Answers to the questions above -- Link to detailed session doc if exists - -** 5. Commit Changes - -Commit PRINCIPLES.org updates and retrospective record. - -* PRINCIPLES.org Structure - -#+BEGIN_SRC org -,* How We Work Together -,** Principle Name -- Bullet points explaining the principle -- When it applies -- Why it matters - -,* Checklists -,** Checklist Name -- [ ] Step 1 -- [ ] Step 2 -#+END_SRC - -* Integration with Session Startup - -Add to project's protocols.org or session startup: -- Check if PRINCIPLES.org was updated since last session -- Review any new principles before starting work - -* Example Principles (Starters) - -** Sync Before Action -- Confirm before destructive or irreversible actions -- State what you're about to do and wait for go-ahead - -** Verify Assumptions -- When something "should work" but doesn't, question the assumption -- Test one variable at a time - -** Clean Up After Yourself -- Reset temporary changes before finishing -- Verify system is in expected state |
