Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 5 additions & 11 deletions .project_management/Backlog.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,17 +37,6 @@ No P0 items pending.

## P2 (Nice to have)

- **ID:** STORY-0203
- **Title:** Provide multilingual bootstrap prompts
- **Description:** Provide translated bootstrap instructions for non-English teams.
- **Acceptance Criteria:**
- Translations include the single-line prompt and no-web fallback.
- Each translation references the same initiator URL.
- **Dependencies:** STORY-0001
- **Risk:** Low
- **Architectural Impact:** Low
- **Notes/Evidence:** See BOOTSTRAP_SENATE.md for context.

- **ID:** STORY-0210
- **Title:** Define self-audit scope and signals
- **Description:** Specify what the system should analyze to detect governance gaps and improvement opportunities.
Expand Down Expand Up @@ -153,6 +142,11 @@ No P0 items pending.
- **Closed in sprint:** Sprint-009
- **Evidence:** `.project_management/completed_sprints/sprint-009.md`

- **ID:** STORY-0203
- **Title:** Provide multilingual bootstrap prompts
- **Closed in sprint:** Sprint-010
- **Evidence:** `.project_management/completed_sprints/sprint-010.md`

- **ID:** STORY-0115
- **Title:** Constituent onboarding kit (voting-ready)
- **Closed in sprint:** Sprint-004
Expand Down
14 changes: 7 additions & 7 deletions .project_management/Current_Sprint.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,32 +2,32 @@

## Sprint Number

Sprint-010
Sprint-011

## Sprint Goal

Provide multilingual bootstrap prompts for non-English constituents.
Define self-audit scope and signals for governance gap detection and improvement recommendations.

## Selected Stories

- STORY-0203 - Provide multilingual bootstrap prompts
- STORY-0210 - Define self-audit scope and signals

## Rationale

Reduce onboarding friction for non-English teams with translated prompts.
Phase 3 requires a clear, safe self-audit scope before proposing or drafting bills.

## Risks

- Translation quality and consistency across languages.
- Keeping translated prompts in sync with updates.
- Overbroad signals that cause noisy or unsafe recommendations.
- Missing HITL gates for sensitive findings.

## Blockers

None.

## Acceptance Summary

Translated bootstrap prompts published and linked.
Self-audit signal spec is published with bill mapping and safety gates.

## Definition of Done Checklist

Expand Down
8 changes: 8 additions & 0 deletions .project_management/Project_Sprint_Log.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,3 +96,11 @@ Append-only sprint ledger. Add one section per sprint and never reset this file.
- Start date: 2026-03-15
- Goal: Provide multilingual bootstrap prompts for non-English constituents.
- Included stories: STORY-0203
- End date: 2026-03-15
- Outcome: Sprint-010 closed; multilingual bootstrap prompts published.
- Rating: 0.8 (see ratings log).

## Sprint-011
- Start date: 2026-03-16
- Goal: Define self-audit scope and signals for governance gaps.
- Included stories: STORY-0210
91 changes: 91 additions & 0 deletions .project_management/completed_sprints/sprint-010.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
# Sprint 010 — Multilingual Bootstrap Prompts

## Sprint Number

Sprint-010

## Start Date

2026-03-15

## End Date

2026-03-15

## Goal

Provide translated bootstrap prompts (single-line + no-web fallback) for non-English teams.

## Included Stories

- STORY-0203 - Provide multilingual bootstrap prompts

## Story Status

- STORY-0203: Done.

## Files Touched

- docs/governance/bootstrap_translations.md
- README.md

## Notes (Architecture/Security)

- Architecture notes: Documentation-only change.
- Security notes: No secrets introduced.
- Decision matrix references: .project_management/Decision_Matrix.md

## Test Results

- Unit tests: N/A (docs)
- Integration tests: Manual verification of translation URLs
- Load/performance tests: N/A
- Security checks: CodeQL (pass), actionlint (pass), shellcheck (pass), Analyze (actions) (pass)

## Review Summary

- What was completed: STORY-0203
- What was deferred: None
- Risks discovered: Translation drift if prompts change; keep in sync.
- Debt introduced/resolved: No new debt introduced.

## Phase/MVP Progress

- Current phase: Phase 2 (Production readiness)
- Phase goals status (on-track / at-risk / blocked): On-track
- Critical path status: Expand onboarding reach via localized prompts.
- Phase gate checklist status (if phase-ending): N/A
- Phase-end report link (if phase-ending): N/A

## Sprint Review Rating

- Rating (0.0–1.0, one decimal): 0.8
- Rationale (tie to senate laws + sprint goal): Delivered multilingual bootstrap prompts with consistent URLs and documentation (LAW-001 alignment) with green CI.
- Running average (from `.project_management/ratings/sprint_ratings.jsonl`): 0.8

## Close-out Checklist

- [x] All done stories have evidence.
- [x] Deferred stories returned to backlog with updated priority.
- [x] Phase/MVP progress status documented.
- [x] Sprint log appended in `Project_Sprint_Log.md`.
- [x] Sprint rating appended in `.project_management/ratings/sprint_ratings.jsonl`.
- [x] `Current_Sprint.md` reset.
- [x] Sprint file moved to `completed_sprints/`.
- [x] Audit log entry appended.
- [x] All PRs green; no merges before checks complete.
- [x] Stale branches pruned; main is clean.

## Retro Notes

- What went well: Clear, concise translations delivered quickly.
- What did not go well: None.
- Process changes for next sprint: Keep translation doc updated when prompts change.

## Closure Signature

Closed by: tecthulhu.senate.ai-worker-01.ai

Date: 2026-03-15

Reference: PR #28
4 changes: 4 additions & 0 deletions .project_management/log/story_management_2026-03-16.log
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{"ts": "2026-03-16T01:43:58Z", "actor": "ai", "change_type": "update", "entity_type": "story", "entity_id": "STORY-0203", "files_touched": [".project_management/stories/STORY-0203.story.md"], "summary": "Marked STORY-0203 done with evidence after PR #28 merge.", "rationale": "Multilingual bootstrap prompts published and linked; acceptance criteria met.", "links": ["https://github.com/tecthulhu/senate/pull/28"]}
{"ts": "2026-03-16T01:43:58Z", "actor": "ai", "change_type": "close", "entity_type": "sprint", "entity_id": "Sprint-010", "files_touched": [".project_management/completed_sprints/sprint-010.md", ".project_management/Project_Sprint_Log.md", ".project_management/ratings/sprint_ratings.jsonl", ".project_management/Current_Sprint.md", ".project_management/state/current_state.json"], "summary": "Closed Sprint-010 with rating and completion summary.", "rationale": "Sprint-010 scope completed with PR #28 and green CI; sprint artifacts updated.", "links": ["https://github.com/tecthulhu/senate/pull/28"]}
{"ts": "2026-03-16T01:43:58Z", "actor": "ai", "change_type": "update", "entity_type": "backlog", "entity_id": "BACKLOG-ARCHIVE", "files_touched": [".project_management/Backlog.md"], "summary": "Archived STORY-0203 from the active backlog.", "rationale": "Backlog completion rule requires moving done stories into Archive section.", "links": []}
{"ts": "2026-03-16T01:43:58Z", "actor": "ai", "change_type": "add", "entity_type": "sprint", "entity_id": "Sprint-011", "files_touched": [".project_management/sprints/sprint-011.md", ".project_management/Current_Sprint.md", ".project_management/state/current_state.json", ".project_management/Project_Sprint_Log.md"], "summary": "Initialized Sprint-011 for self-audit scope and signal definition.", "rationale": "Sprint-010 closed; proceed to Phase 3 self-analysis foundation work.", "links": []}
1 change: 1 addition & 0 deletions .project_management/ratings/sprint_ratings.jsonl
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,4 @@
{"sprint_id":"Sprint-007","closed_date":"2026-03-15","rating":0.8,"rationale":"Clarified executive override workflow and added onboarding FAQ (LAW-012/LAW-004 alignment) with green CI.","average_after":0.8}
{"sprint_id":"Sprint-008","closed_date":"2026-03-15","rating":0.8,"rationale":"Delivered optional bootstrap helper CLI with integrity verification and clear docs while preserving AI-first flow.","average_after":0.8}
{"sprint_id":"Sprint-009","closed_date":"2026-03-15","rating":0.8,"rationale":"Published example constituent repo and linked it from senate docs once approval arrived.","average_after":0.8}
{"sprint_id":"Sprint-010","closed_date":"2026-03-15","rating":0.8,"rationale":"Published multilingual bootstrap prompts with consistent URLs and documentation links.","average_after":0.8}
Original file line number Diff line number Diff line change
@@ -1,62 +1,62 @@
# Sprint 010Multilingual Bootstrap Prompts
# Sprint 011Self-Audit Scope and Signals

## Sprint Number

Sprint-010
Sprint-011

## Start Date

2026-03-15
2026-03-16

## End Date

TBD

## Goal

Provide translated bootstrap prompts (single-line + no-web fallback) for non-English teams.
Define self-audit scope and signals for governance gap detection, including bill mappings and safety gates.

## Included Stories

- STORY-0203 - Provide multilingual bootstrap prompts
- STORY-0210 - Define self-audit scope and signals

## Files Touched

- TBD

## Notes (Architecture/Security)

- Architecture notes:
- Security notes:
- Architecture notes: Specify audit signals and mapping to governance actions.
- Security notes: No secret leakage; adhere to LAW-004 token handling.
- Decision matrix references: .project_management/Decision_Matrix.md

## Test Results

- Unit tests:
- Integration tests:
- Load/performance tests:
- Security checks:
- Unit tests: N/A (docs/process)
- Integration tests: Manual verification of referenced files/steps
- Load/performance tests: N/A
- Security checks: N/A (documentation)

## Review Summary

- What was completed:
- What was deferred:
- Risks discovered:
- Debt introduced/resolved:
- What was completed: TBD
- What was deferred: TBD
- Risks discovered: TBD
- Debt introduced/resolved: TBD

## Phase/MVP Progress

- Current phase: Phase 2 (Production readiness)
- Current phase: Phase 3 (Self-analysis and autonomous proposal)
- Phase goals status (on-track / at-risk / blocked): On-track
- Critical path status: Expand onboarding reach via localized prompts.
- Critical path status: Establish safe audit scope before automated bill proposals.
- Phase gate checklist status (if phase-ending): N/A
- Phase-end report link (if phase-ending): N/A

## Sprint Review Rating

- Rating (0.0–1.0, one decimal):
- Rationale (tie to senate laws + sprint goal):
- Running average (from `.project_management/ratings/sprint_ratings.jsonl`):
- Rating (0.0–1.0, one decimal): TBD
- Rationale (tie to senate laws + sprint goal): TBD
- Running average (from `.project_management/ratings/sprint_ratings.jsonl`): TBD

## Close-out Checklist

Expand All @@ -73,14 +73,14 @@ Provide translated bootstrap prompts (single-line + no-web fallback) for non-Eng

## Retro Notes

- What went well:
- What did not go well:
- Process changes for next sprint:
- What went well: TBD
- What did not go well: TBD
- Process changes for next sprint: TBD

## Closure Signature

Closed by: <name_or_system>
Closed by: TBD

Date: YYYY-MM-DD
Date: TBD

Reference: <commit_or_pr_or_ticket>
Reference: TBD
10 changes: 5 additions & 5 deletions .project_management/state/current_state.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"phase": 2,
"active_sprint": "Sprint-010",
"phase": 3,
"active_sprint": "Sprint-011",
"active_story_ids": [
"STORY-0203"
"STORY-0210"
],
"blocked_story_ids": [],
"pending_hitl_gate": null,
"notes": "Sprint-010 planned for multilingual bootstrap prompts.",
"last_updated": "2026-03-16T01:33:44Z"
"notes": "Sprint-011 planned for self-audit scope and signals.",
"last_updated": "2026-03-16T01:42:35Z"
}
21 changes: 13 additions & 8 deletions .project_management/stories/STORY-0203.story.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,16 +10,16 @@ Provide translated bootstrap instructions for non-English teams.
Constituents and maintainers benefit from provide multilingual bootstrap prompts.

## Acceptance criteria
- [ ] Translations include the single-line prompt and no-web fallback.
- [ ] Each translation references the same initiator URL.
- [x] Translations include the single-line prompt and no-web fallback.
- [x] Each translation references the same initiator URL.

## Non-functional requirements
- Security: No secret leakage; follow LAW-004 for token handling.
- Reliability: Documentation and scripts must be deterministic and repeatable.
- Performance: N/A (documentation/process).

## Implementation notes
See BOOTSTRAP_SENATE.md for detailed context and acceptance criteria.
Published translations in a dedicated governance doc and linked it from README.

## Test plan
- Unit: N/A (docs/process)
Expand All @@ -38,8 +38,13 @@ Revert the changes to restore prior governance documentation.
- Low

## Definition of Done checklist
- [ ] AC met
- [ ] Tests added + passing
- [ ] Lint/format/type checks pass
- [ ] Security checks pass
- [ ] Docs updated
- [x] AC met
- [x] Tests added + passing (N/A — docs)
- [x] Lint/format/type checks pass (N/A — docs)
- [x] Security checks pass (N/A — docs)
- [x] Docs updated

## Evidence
- `docs/governance/bootstrap_translations.md`
- `README.md` (Quick Links)
- PR: https://github.com/tecthulhu/senate/pull/28
Loading