coulomb/agentic-resources
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

AGENTIC-WP-0001: complete T02 + close bootstrap workplan

Browse Source 
T02 was the one genuinely-incomplete bootstrap task: AGENTS.md had no
dev-workflow section. Added one documenting the pure-stdlib Python 3.11+
toolchain, pytest, and the session_memory ingest/detect/curate entrypoints so
future sessions can verify changes. T01 (integration files) and T03 (first real
workplan) were already satisfied; reconciled stale ready/todo bookkeeping to
finished/done.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Bernd Worsch
2026-06-07 10:15:23 +02:00
parent d06791f070
commit 56b2f576de
2 changed files with 30 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
AGENTS.md
View File

@@ -11,6 +11,31 @@
--- ---
## Dev Workflow
The deliverable code lives in `session_memory/` (the Helix Forge coding-session
memory system). It is **pure-stdlib Python 3.11+** — `tomllib`, `sqlite3`,
`dataclasses`; no third-party runtime dependencies and no build step. `pytest` is
the only dev dependency. Run everything from the repo root.
| Need | Command |
|------|---------|
| Python | `python3` (3.11+ required for `tomllib`; developed on 3.12) |
| Install deps | none at runtime; for tests: `pip install pytest` (or `uv pip install pytest`) |
| Test | `python3 -m pytest` (full suite) · `python3 -m pytest tests/test_curate_review.py` (one file) · `-q` for quiet |
| Lint / build | none configured — keep changes matching surrounding style |
| Run: ingest sweep | `python3 -m session_memory.ingest` (`--dry-run`, `--config PATH`) |
| Run: detect | `python3 -m session_memory.detect` (`--json`, `--min-frequency N`) |
| Run: curate | `python3 -m session_memory.curate` (`--auto-approve`, `--json`) |
| Config | `session_memory/config.toml`; local store under `session_memory/.store/` (gitignored) |
**Verify a change before declaring it done:** run `python3 -m pytest` (expect all
green), and for pipeline changes do a live `ingest → detect → curate` pass against
the local store. See `session_memory/README.md` for the full layout and the
detect → curate → distribute flow.
---
## State Hub Integration ## State Hub Integration
The Custodian State Hub tracks work across all domains. Interact via HTTP REST — The Custodian State Hub tracks work across all domains. Interact via HTTP REST —

10
workplans/AGENTIC-WP-0001-statehub-bootstrap.md
View File

@@ -4,11 +4,11 @@ type: workplan
title: "Bootstrap State Hub integration" title: "Bootstrap State Hub integration"
domain: helix_forge domain: helix_forge
repo: agentic-resources repo: agentic-resources
status: ready status: finished
owner: codex owner: codex
topic_slug: helix-forge topic_slug: helix-forge
created: "2026-06-06" created: "2026-06-06"
updated: "2026-06-06" updated: "2026-06-07"
state_hub_workstream_id: "bb9a43a3-a54f-434b-97c2-e1c7142b52f5" state_hub_workstream_id: "bb9a43a3-a54f-434b-97c2-e1c7142b52f5"
--- ---
@@ -20,7 +20,7 @@ Iterating towards optimal agentic performance.
```task ```task
id: AGENTIC-WP-0001-T01 id: AGENTIC-WP-0001-T01
status: todo status: done
priority: high priority: high
state_hub_task_id: "3ad7b7a9-ee5b-40e7-bd83-d6f0d1db7867" state_hub_task_id: "3ad7b7a9-ee5b-40e7-bd83-d6f0d1db7867"
``` ```
@@ -32,7 +32,7 @@ Replace generated placeholders with repo-specific facts where needed.
```task ```task
id: AGENTIC-WP-0001-T02 id: AGENTIC-WP-0001-T02
status: todo status: done
priority: high priority: high
state_hub_task_id: "db248d57-8e1b-41ef-8386-c04ba490bc6d" state_hub_task_id: "db248d57-8e1b-41ef-8386-c04ba490bc6d"
``` ```
@@ -45,7 +45,7 @@ changes confidently.
```task ```task
id: AGENTIC-WP-0001-T03 id: AGENTIC-WP-0001-T03
status: todo status: done
priority: medium priority: medium
state_hub_task_id: "9cbb7aa5-dd49-48e2-b5a0-1670584aecf7" state_hub_task_id: "9cbb7aa5-dd49-48e2-b5a0-1670584aecf7"
``` ```