Skip to content

Commit 9642892

Browse files
committed
feat: add council-lite session lifecycle and roadmap track
1 parent 411dd3e commit 9642892

9 files changed

Lines changed: 339 additions & 40 deletions

File tree

.github/workflows/validate.yml

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,5 +43,15 @@ jobs:
4343
run: |
4444
./install.sh --profiles core,council-lite
4545
./scripts/council-lite.sh status
46-
./scripts/council-lite.sh start "CI smoke test goal"
46+
./scripts/council-lite.sh run "CI smoke test goal"
47+
./scripts/council-lite.sh list
48+
SESSION_ID=$(python3 - <<'PY'
49+
import json
50+
from pathlib import Path
51+
52+
data = json.loads(Path("memory/council-lite/index.json").read_text())
53+
print(data["sessions"][-1]["id"])
54+
PY
55+
)
56+
./scripts/council-lite.sh resume "$SESSION_ID"
4757
./install.sh --uninstall

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,8 @@ Common commands:
4343
./install.sh --disable-profile council-lite
4444

4545
# start a council-lite session scaffold
46-
./scripts/council-lite.sh start "Design safe billing webhooks"
46+
./scripts/council-lite.sh run "Design safe billing webhooks"
47+
./scripts/council-lite.sh list
4748
```
4849

4950
Profile state is persisted at:

commands/council-lite.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,13 @@ Script:
88
Usage:
99
```bash
1010
./scripts/council-lite.sh status
11-
./scripts/council-lite.sh start "Design safe billing webhooks"
11+
./scripts/council-lite.sh list
12+
./scripts/council-lite.sh run "Design safe billing webhooks"
13+
./scripts/council-lite.sh resume <session-id>
1214
```
1315

1416
Notes:
1517
- `council-lite` profile must be enabled.
1618
- Enable with `./install.sh --enable-profile council-lite`.
17-
- Session scaffold is written to `memory/COUNCIL-LITE-<timestamp>.md`.
19+
- Sessions are written to `memory/council-lite/<session-id>/`.
20+
- Artifacts include intake, assembly, deliberation rounds, and execution plan.

docs/profiles.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,9 @@ This file is created or updated during install/profile changes.
4242
After enabling `council-lite`, run:
4343

4444
```bash
45-
./scripts/council-lite.sh start "Design safe billing webhooks"
45+
./scripts/council-lite.sh run "Design safe billing webhooks"
46+
./scripts/council-lite.sh list
47+
./scripts/council-lite.sh resume <session-id>
4648
```
4749

4850
## Experimental Warning: council-research

docs/release-checklist.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,8 @@ Use this checklist before tagging a release.
2121
- [ ] `./install.sh --profiles core,council-lite`
2222
- [ ] `./install.sh --enable-profile council-research`
2323
- [ ] `./install.sh --disable-profile council-research`
24-
- [ ] `./scripts/council-lite.sh start "Smoke test"`
24+
- [ ] `./scripts/council-lite.sh run "Smoke test"`
25+
- [ ] `./scripts/council-lite.sh list`
2526
- [ ] `./install.sh --uninstall`
2627
- [ ] experimental warning shown when `council-research` is enabled
2728
- [ ] profile state removed on uninstall (`~/.config/opencode/profiles-enabled.json`)

docs/roadmap.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,24 @@
3030
- GitHub issue and PR templates
3131
- security and code of conduct policies
3232
- release checklist for publish workflow
33+
34+
## Phase 6: Profile Platform (in progress)
35+
- profile registry and manifests
36+
- profile-aware installer with persisted state
37+
- clean uninstall with state removal
38+
- stability labels (`stable`, `beta`, `experimental`)
39+
- profile docs and adoption path
40+
41+
## Phase 7: Council Lite General-Usage Track
42+
- implement executable council-lite session flow (`run`)
43+
- generate structured session artifacts (intake, assembly, rounds, plan)
44+
- add session lifecycle commands (`list`, `resume`, `status`)
45+
- add artifact-level quality checks and CI smoke coverage
46+
- define promotion criteria from `beta` to `stable`
47+
48+
## Phase 8: Council Research Maturation Track
49+
- run experimental battle-testing program with evidence log
50+
- add evaluation signals (consistency, contradiction, actionability)
51+
- iterate orchestration patterns and prompt contracts
52+
- define graduation gates from `experimental` to `beta`
53+
- publish migration guidance from council-lite to council-research

docs/workflows-playbook.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,12 @@ This creates one branch and one draft PR per issue.
5656

5757
```bash
5858
./scripts/council-lite.sh status
59-
./scripts/council-lite.sh start "Design safe billing webhooks"
59+
./scripts/council-lite.sh list
60+
./scripts/council-lite.sh run "Design safe billing webhooks"
61+
./scripts/council-lite.sh resume <session-id>
6062
```
6163

6264
Notes:
6365
- requires `council-lite` profile enabled
64-
- creates `memory/COUNCIL-LITE-<timestamp>.md` scaffold
66+
- creates session artifacts in `memory/council-lite/<session-id>/`
67+
- includes intake, assembly, deliberation rounds, and plan templates

profiles/council-lite/README.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,14 @@ Council Lite provides a lightweight deliberation workflow on top of the core pro
1818
## Quick Start
1919

2020
```bash
21-
./scripts/council-lite.sh start "Design safe billing webhooks"
21+
./scripts/council-lite.sh run "Design safe billing webhooks"
22+
./scripts/council-lite.sh list
23+
./scripts/council-lite.sh resume <session-id>
2224
```
2325

24-
This generates a session scaffold in `memory/` with recommended agents and execution flow.
26+
This initializes a structured session under `memory/council-lite/<session-id>/` with:
27+
28+
- intake
29+
- assembly
30+
- deliberation rounds (position/challenge/converge)
31+
- execution plan

0 commit comments

Comments
 (0)