pqrst-practice/workplans/PQRST-WP-0001-statehub-bootstrap.md

78 lines
2.3 KiB
Markdown
Raw Normal View History

---
id: PQRST-WP-0001
type: workplan
title: "Bootstrap State Hub integration"
domain: agents
repo: pqrst-practice
Complete PQRST-WP-0001: bootstrap State Hub integration T01 — Reviewed the generated integration files. Resolved the {CREDENTIAL_ROUTING} placeholder in AGENTS.md from the fleet canon, refreshed the SCOPE.md repository layout (stale after registration), and replaced the README stub with orientation and entry points. T02 — Documented the developer workflow in AGENTS.md. This is a Markdown-only spec repository: nothing to install, build, or run, and no test suite. In place of a toolchain, added a six-point verification checklist covering prompt/spec coupling, the closed 5-tuple, example-record arithmetic, cross-references, version discipline, and the append-only rule for history/. The signature validation command is verified working — all nine example signatures sum to 100. T03 — Seeded PQRST-WP-0002 "Validate spec v0.1 against real sessions and cut v0.2": pilot the closing prompt unassisted on at least eight real sessions, decide the record-storage boundary SCOPE.md leaves open, then revise. v0.1 was consolidated from two drafts neither of which had been applied to a session, so the open questions are empirical rather than editorial. WP-0001 marked finished with DoR/DoD assessments (clears C-34). No open residuals — the follow-on work is carried by PQRST-WP-0002. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SQ6oF1DtVDKcD1FCpvRVLx Assistant: claude-code Assistant-Model: opus Assistant-Process: 272883@bnt-lap001 Assistant-Session: f40c8f53-fb65-4980-9d29-bcdb3dd946f7
2026-09-05 20:38:30 +02:00
status: finished
owner: codex
topic_slug: practice
created: "2026-09-05"
updated: "2026-09-05"
Complete PQRST-WP-0001: bootstrap State Hub integration T01 — Reviewed the generated integration files. Resolved the {CREDENTIAL_ROUTING} placeholder in AGENTS.md from the fleet canon, refreshed the SCOPE.md repository layout (stale after registration), and replaced the README stub with orientation and entry points. T02 — Documented the developer workflow in AGENTS.md. This is a Markdown-only spec repository: nothing to install, build, or run, and no test suite. In place of a toolchain, added a six-point verification checklist covering prompt/spec coupling, the closed 5-tuple, example-record arithmetic, cross-references, version discipline, and the append-only rule for history/. The signature validation command is verified working — all nine example signatures sum to 100. T03 — Seeded PQRST-WP-0002 "Validate spec v0.1 against real sessions and cut v0.2": pilot the closing prompt unassisted on at least eight real sessions, decide the record-storage boundary SCOPE.md leaves open, then revise. v0.1 was consolidated from two drafts neither of which had been applied to a session, so the open questions are empirical rather than editorial. WP-0001 marked finished with DoR/DoD assessments (clears C-34). No open residuals — the follow-on work is carried by PQRST-WP-0002. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SQ6oF1DtVDKcD1FCpvRVLx Assistant: claude-code Assistant-Model: opus Assistant-Process: 272883@bnt-lap001 Assistant-Session: f40c8f53-fb65-4980-9d29-bcdb3dd946f7
2026-09-05 20:38:30 +02:00
quality_dor: DoR-Ok
quality_dor_at: "2026-09-05"
quality_dor_by: claude-code
quality_dor_note: "Bootstrap plan generated by statehub register; scope was fixed and fully known at creation."
quality_dod: DoD-Ok
quality_dod_at: "2026-09-05"
quality_dod_by: claude-code
quality_dod_note: "T01 resolved the CREDENTIAL_ROUTING placeholder and refreshed SCOPE.md/README.md; T02 documented the (empty) toolchain and a verification checklist in AGENTS.md, checklist command run and passing; T03 seeded PQRST-WP-0002. Residual handed off as PQRST-WP-0002."
related:
- PQRST-WP-0002
state_hub_workstream_id: "a1774666-54fd-58c8-b093-7fb40c468c86"
---
# Bootstrap State Hub integration
Retrospective PQRST estimation practice for closing agentic coding sessions.
Complete PQRST-WP-0001: bootstrap State Hub integration T01 — Reviewed the generated integration files. Resolved the {CREDENTIAL_ROUTING} placeholder in AGENTS.md from the fleet canon, refreshed the SCOPE.md repository layout (stale after registration), and replaced the README stub with orientation and entry points. T02 — Documented the developer workflow in AGENTS.md. This is a Markdown-only spec repository: nothing to install, build, or run, and no test suite. In place of a toolchain, added a six-point verification checklist covering prompt/spec coupling, the closed 5-tuple, example-record arithmetic, cross-references, version discipline, and the append-only rule for history/. The signature validation command is verified working — all nine example signatures sum to 100. T03 — Seeded PQRST-WP-0002 "Validate spec v0.1 against real sessions and cut v0.2": pilot the closing prompt unassisted on at least eight real sessions, decide the record-storage boundary SCOPE.md leaves open, then revise. v0.1 was consolidated from two drafts neither of which had been applied to a session, so the open questions are empirical rather than editorial. WP-0001 marked finished with DoR/DoD assessments (clears C-34). No open residuals — the follow-on work is carried by PQRST-WP-0002. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SQ6oF1DtVDKcD1FCpvRVLx Assistant: claude-code Assistant-Model: opus Assistant-Process: 272883@bnt-lap001 Assistant-Session: f40c8f53-fb65-4980-9d29-bcdb3dd946f7
2026-09-05 20:38:30 +02:00
**Outcome:** integration files reviewed and completed, the developer workflow
(there is no toolchain) and a verification checklist documented in `AGENTS.md`,
and `PQRST-WP-0002` seeded as the first real workplan.
**Residuals:** none open. The substantive follow-on work — validating v0.1
against real sessions and deciding where records are stored — is carried by
`PQRST-WP-0002`.
## Review Generated Integration Files
```task
id: PQRST-WP-0001-T01
Complete PQRST-WP-0001: bootstrap State Hub integration T01 — Reviewed the generated integration files. Resolved the {CREDENTIAL_ROUTING} placeholder in AGENTS.md from the fleet canon, refreshed the SCOPE.md repository layout (stale after registration), and replaced the README stub with orientation and entry points. T02 — Documented the developer workflow in AGENTS.md. This is a Markdown-only spec repository: nothing to install, build, or run, and no test suite. In place of a toolchain, added a six-point verification checklist covering prompt/spec coupling, the closed 5-tuple, example-record arithmetic, cross-references, version discipline, and the append-only rule for history/. The signature validation command is verified working — all nine example signatures sum to 100. T03 — Seeded PQRST-WP-0002 "Validate spec v0.1 against real sessions and cut v0.2": pilot the closing prompt unassisted on at least eight real sessions, decide the record-storage boundary SCOPE.md leaves open, then revise. v0.1 was consolidated from two drafts neither of which had been applied to a session, so the open questions are empirical rather than editorial. WP-0001 marked finished with DoR/DoD assessments (clears C-34). No open residuals — the follow-on work is carried by PQRST-WP-0002. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SQ6oF1DtVDKcD1FCpvRVLx Assistant: claude-code Assistant-Model: opus Assistant-Process: 272883@bnt-lap001 Assistant-Session: f40c8f53-fb65-4980-9d29-bcdb3dd946f7
2026-09-05 20:38:30 +02:00
status: done
priority: high
state_hub_task_id: "9dd0cdb6-a0bb-5355-9804-eb7dd40c45f2"
```
Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
Replace generated placeholders with repo-specific facts where needed.
## Verify Local Developer Workflow
```task
id: PQRST-WP-0001-T02
Complete PQRST-WP-0001: bootstrap State Hub integration T01 — Reviewed the generated integration files. Resolved the {CREDENTIAL_ROUTING} placeholder in AGENTS.md from the fleet canon, refreshed the SCOPE.md repository layout (stale after registration), and replaced the README stub with orientation and entry points. T02 — Documented the developer workflow in AGENTS.md. This is a Markdown-only spec repository: nothing to install, build, or run, and no test suite. In place of a toolchain, added a six-point verification checklist covering prompt/spec coupling, the closed 5-tuple, example-record arithmetic, cross-references, version discipline, and the append-only rule for history/. The signature validation command is verified working — all nine example signatures sum to 100. T03 — Seeded PQRST-WP-0002 "Validate spec v0.1 against real sessions and cut v0.2": pilot the closing prompt unassisted on at least eight real sessions, decide the record-storage boundary SCOPE.md leaves open, then revise. v0.1 was consolidated from two drafts neither of which had been applied to a session, so the open questions are empirical rather than editorial. WP-0001 marked finished with DoR/DoD assessments (clears C-34). No open residuals — the follow-on work is carried by PQRST-WP-0002. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SQ6oF1DtVDKcD1FCpvRVLx Assistant: claude-code Assistant-Model: opus Assistant-Process: 272883@bnt-lap001 Assistant-Session: f40c8f53-fb65-4980-9d29-bcdb3dd946f7
2026-09-05 20:38:30 +02:00
status: done
priority: high
state_hub_task_id: "1100f857-e774-5861-9b03-e6cfd2472a4b"
```
Identify the repo's install, test, lint, build, and run commands. Add or refine
those commands in the agent instructions so future coding sessions can verify
changes confidently.
## Seed First Real Workplan
```task
id: PQRST-WP-0001-T03
Complete PQRST-WP-0001: bootstrap State Hub integration T01 — Reviewed the generated integration files. Resolved the {CREDENTIAL_ROUTING} placeholder in AGENTS.md from the fleet canon, refreshed the SCOPE.md repository layout (stale after registration), and replaced the README stub with orientation and entry points. T02 — Documented the developer workflow in AGENTS.md. This is a Markdown-only spec repository: nothing to install, build, or run, and no test suite. In place of a toolchain, added a six-point verification checklist covering prompt/spec coupling, the closed 5-tuple, example-record arithmetic, cross-references, version discipline, and the append-only rule for history/. The signature validation command is verified working — all nine example signatures sum to 100. T03 — Seeded PQRST-WP-0002 "Validate spec v0.1 against real sessions and cut v0.2": pilot the closing prompt unassisted on at least eight real sessions, decide the record-storage boundary SCOPE.md leaves open, then revise. v0.1 was consolidated from two drafts neither of which had been applied to a session, so the open questions are empirical rather than editorial. WP-0001 marked finished with DoR/DoD assessments (clears C-34). No open residuals — the follow-on work is carried by PQRST-WP-0002. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SQ6oF1DtVDKcD1FCpvRVLx Assistant: claude-code Assistant-Model: opus Assistant-Process: 272883@bnt-lap001 Assistant-Session: f40c8f53-fb65-4980-9d29-bcdb3dd946f7
2026-09-05 20:38:30 +02:00
status: done
priority: medium
state_hub_task_id: "174d689e-5fc4-5fe1-93cb-1fcf0f801e7f"
```
Create the first implementation workplan for the repository's most important
next change. After workplan file updates, run the sync locally from this repo
checkout:
```bash
statehub fix-consistency
```