Skip to content

Commit b852c96

Browse files
committed
refactor: move decision-capture to examples/decision/route (generic template)
- Moved from workflow/ to examples/decision/route.workflow.list - Updated to be project-agnostic (removes workflow-as-list specific assumptions) - Enables reuse across projects via import: URL NOTE: workflow/ is for project-specific workflows, examples/ is for reusable templates
1 parent a7d7400 commit b852c96

File tree

2 files changed

+23
-18
lines changed

2 files changed

+23
-18
lines changed

.tmp/traceflux-plan.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,20 +14,21 @@ Use workflow-as-list to manage traceflux development, creating feedback loop.
1414

1515
## Phase 1: workflow-as-list Foundation
1616

17-
- [ ] Create Issue: "decision-capture workflow" proposal
18-
- [ ] Create `workflow/decision-capture.workflow.list`
17+
- [x] Create Issue: "decision-capture workflow" proposal (#39)
18+
- [x] Create `workflow/decision-capture.workflow.list`
1919
- [ ] Test: Process one real decision
2020

2121
---
2222

23-
## Phase 2: traceflux Setup
23+
## Phase 2: traceflux Setup [COMPLETE]
2424

25-
- [ ] `traceflux/workflow/README.md` (self-hosting purpose)
26-
- [ ] `traceflux/.github/ISSUE_TEMPLATE/decision.yml` (temporary decisions)
27-
- [ ] `traceflux/workflow/commit.workflow.list` (remote import test)
25+
- [x] `traceflux/workflow/README.md` (self-hosting purpose)
26+
- [x] `traceflux/.github/ISSUE_TEMPLATE/decision.yml` (temporary decisions)
27+
- [x] `traceflux/workflow/commit.workflow.list` (remote import test)
2828
- URL: `https://raw.githubusercontent.com/tracer-mohist/workflow-as-list/refs/heads/main/examples/git/commit.workflow.list`
29-
- [ ] `traceflux/scripts/check-code-quality.py` (adapt for traceflux)
30-
- [ ] `traceflux/scripts/check-docs-quality.py` (adapt for traceflux)
29+
- [x] `traceflux/workflow/decision-capture.workflow.list` (adapted)
30+
- [ ] `traceflux/scripts/check-code-quality.py` (adapt for traceflux) [NEXT]
31+
- [ ] `traceflux/scripts/check-docs-quality.py` (adapt for traceflux) [NEXT]
3132

3233
---
3334

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,19 @@
1-
# decision-capture.workflow.list
2-
# Purpose: Route information to correct destination (Issue vs Docs)
1+
# route.workflow.list
2+
# Purpose: Route decisions to correct destination (Issue vs Docs)
33
#
44
# Contract:
55
# Pre: Have information/decision to record
66
# Post: Information stored in appropriate place
7-
# Invariant: No decision lost, no docs polluted with tmp
7+
# Invariant: No decision lost, no docs polluted with temporary content
88
#
99
# Philosophy:
1010
# Issue = Temporary decisions (short lifetime, project-specific)
1111
# Docs = Permanent rules (long lifetime, general principles)
12-
# Arrow: -> (ASCII, not unicode)
12+
#
13+
# Customization:
14+
# - Adjust classification questions for your context
15+
# - Replace issue template paths with your templates
16+
# - Modify doc targets for your documentation structure
1317

1418
# WHY: Temporary decisions clutter docs, permanent ideas need docs not issues
1519
- (classify) Determine destination based on lifetime and scope
@@ -20,19 +24,19 @@
2024

2125
# WHY: Issues have structure for decision tracking (labels, assignees, discussions)
2226
- (create-issue) If temporary decision:
23-
- Show: Available issue templates
24-
- Ask: Use decision.yml template? (yes/no)
25-
- If yes: Open GitHub issue with decision template
26-
- Fields: Title, Decision context, Options considered, Rationale
27+
- Show: Available issue templates in your project
28+
- Ask: Use decision template? (yes/no)
29+
- If yes: Open issue with decision template
30+
- Fields: Title, Context, Options considered, Rationale
2731
- Tags: decision, tmp
2832
- Assign: Decision owner (optional)
2933
- Link: Related files/code (if any)
3034

3135
# WHY: Docs are for timeless rules (functors, not instances)
3236
- (update-docs) If permanent rule:
33-
- Ask: Which doc needs update? (README, docs/, workflow/)
37+
- Ask: Which doc needs update? (README, docs/, or other)
3438
- Ask: What section? (or create new)
35-
- Format: Follow prompt-engineering principles
39+
- Format: Follow your documentation standards
3640
- Commit: "docs: <decision summary>"
3741
- Push: Create PR if needed
3842

0 commit comments

Comments
 (0)