e74d8899fd
feat(ci): gate live-hooks reintroduction in docs/ (ag-rryf #doc-hooks-drift-gate) ( #713 )
...
## What
Adds `scripts/check-doc-hooks-drift.sh` — a CI regression guard that
fails when a **live-facing** doc reintroduces a live hooks runtime after
the 3.0 hookless teardown:
- `hooks/hooks.json` (retired manifest), a `hooks/<name>.sh` runtime
path,
- `ao hooks` (not a registered command — verified absent from
`cli/cmd/ao/`),
- a bare `session-{start,end,autostart}*.sh` hook-file ref
…unless the **same line** hedges it as hookless / opt-in / historical /
removed / a git-hook. Companion to `sync-skill-counts.sh` (skill-count
drift) and `check-hookless-cold-start.sh` (fixed-list cold-start gate).
## Scope (and why the exclusions)
`docs/` **minus** surfaces that legitimately/archivally name hooks:
- **archival history** — `CHANGELOG.md`, `releases/`, `learnings/`,
`plans/`, `adr/`, `convergence/`, `sovereignty-proof/` (document the
past / the removal itself)
- **opt-in subsystem** — `contracts/` (hooks-authoring opt-in specs),
`runbooks/` (diagnostic enumeration), `code-map/` (point-in-time audits)
The gate keeps the onboarding / operator / architecture narrative
hookless.
## Also: finishes the ag-t1ca residue the gate flags
The ag-t1ca de-hooking missed 8 live-facing lines (gate caught them);
each is reframed:
- stale `ao hooks` command/smoke refs → removed / `ao doctor`
(`cli-skills-map`, `UPGRADING`, `release-e2e-checklist`,
`contracts/release-readiness`)
- present-tense hooks-as-rules → CI gates (`strategic-direction`)
- hook-runtime mentions → `ao curate constrain` / opt-in framing
(`curation-pipeline`, `leverage-points`, `SCHEMAS` legacy-manifest
label, `workflows/session-lifecycle`)
## Verification
- `scripts/check-doc-hooks-drift.sh` → PASS on this branch (FAILed on
all 8 before the reframes)
- `tests/scripts/check-doc-hooks-drift.bats` → 8/8 (positive /
negative×3 / hedge×2 / exclusion / no-docs error)
- `shellcheck` clean · `markdownlint` 0 errors (9 docs) ·
`validate-cli-skills-map.sh` PASS · `generate-ci-jobs-table.sh --check`
PASS · existing `check-hookless-cold-start.sh` still green
- Wired into `validate.yml` lint/contracts (gated on docs/ci/shell
changes) + auto-run via the bats suite
Closes-scenario: ag-rryf#doc-hooks-drift-gate
Bounded-context: BC2-Validation
Evidence: scripts/check-doc-hooks-drift.sh
2026-06-03 22:38:26 -04:00
78fc0e64f5
docs: de-hook the 6 big operator/architecture docs (ag-t1ca #big-files) ( #711 )
...
## What
Completes the hooks-runtime decoupling (ag-t1ca) — the 6 large files,
each de-hooked by a dedicated verify-first pass (no `hooks/` dir, no
`hooks.json`, `ao hooks` absent, hook `.sh` files absent; CI = the
authoritative gate).
| File | Reframe |
|---|---|
| ARCHITECTURE.md | hooks-as-enforcement / `hooks/ # 12 hook scripts`
dir / "Session Hooks" → CI gates + `ao` commands + "Session Lifecycle";
82-skill breakdown intact |
| agentops-system-map.md | "52 Skills/121 CLI/13 hook entries" →
"82/76/hookless (CI-gated)"; hook-enforcement section → hookless mapping
|
| context-lifecycle.md | hook-file citations → real mechanisms (CI gate
+ `/pre-mortem`,`/validate`,`/post-mortem` + `ao constraint`/`ao
findings`) |
| leverage-points.md | "3 active hooks"/push-gate/pre-mortem-gate → CI
gates + skill steps; resolved the doc's own active-vs-guardrail
contradiction |
| troubleshooting.md | "Hooks aren't running" / "push gate hook" / `ao
hooks test` → hookless guidance; **ROADMAP.md link kept** (audit's
"broken link" was a false positive) |
| INCIDENT-RUNBOOK.md | Scenario C "Hook Scripts Fail" + Per-Hook Kill
Switches → 3.0 "Skills Not Loading / CI Gate Failing";
`AGENTOPS_HOOKS_DISABLED` kept only as user-authored-hooks opt-out |
| agentops-brief.md | "73 shared skills/12 Hook Events"/"Startup hooks"
→ 82 skills, hookless lifecycle |
## Verification (aggregate, by me — not just subagent self-reports)
- `markdownlint -c .markdownlint.json` (all docs) → **0 errors**
- `tests/docs/validate-links.sh` → **0 broken** (2902 checked)
- `scripts/sync-skill-counts.sh --check` → clean (ARCHITECTURE.md gate
target intact)
- residual hooks-as-live-runtime grep across all 7 → only correct
negation/opt-in framing remains
- net −41 lines (reframe, not gutting)
Closes-scenario: ag-t1ca#big-files
Bounded-context: BC1-Corpus
Evidence: docs/ARCHITECTURE.md
2026-06-03 22:05:09 -04:00
a427dcce6d
docs(positioning): assurance profile + goals as reconcile setpoints (soc-sx99) ( #257 )
...
* docs(positioning): add assurance profile for agent factory rigor
* docs(positioning): frame goals as reconcile setpoints
* chore(scripts): suppress SC2034 on bd_out — set by run_capture via name-ref
Drive-by fix needed to push crank/soc-sx99 — pre-push shellcheck flagged
bd_out as unused in test-rpi-surface-smoke.sh, but it is set indirectly by
run_capture's name-ref pattern. Adds a targeted shellcheck disable comment.
2026-05-07 17:50:17 -04:00
0030790283
feat(skills): encode evidence-driven anti-patterns, unify flywheel metrics, add normalization defect detection
...
- Create global ~/.agents/MEMORY.md with 7 universal principles and top patterns
- Unify sigma/rho/delta definitions across skills/docs/code (code is truth)
- Add normalization defect scan to Athena defrag (placeholder, stacked frontmatter, bundled, dupes)
- Add anti-pattern pre-flight to /plan (dead infra, brainstorm-as-plan, 40% context, commit cadence)
- Expand pre-mortem from top-5 to top-8 FAIL patterns (dead infra activation, rollback maps, four-surface closure)
- Add 4 new forge uncaptured lesson categories (normalization defects, promotion pipeline, taxonomy, stale contradictions)
- Add normalization defect check to post-mortem four-surface closure
- Fix pre-existing broken link in flywheel-diagnostics.md (regex in code block)
- Sync all changes to skills-codex with Codex-specific adaptations preserved
2026-03-30 15:27:49 -04:00
0e62657856
docs(flywheel): close prevention-ratchet validation loop
2026-03-10 07:44:59 -04:00
899c0eaea5
feat: add finding registry prevention ratchet
2026-03-09 16:44:54 -04:00
4abd2a69be
docs(context): sweep remaining ao inject references across docs/tests/scripts
...
Wave 3 of context-enforcement-phase3: replace ao inject workflow
guidance with ao lookup across documentation, test fixtures, and
scripts. Remaining 32 references are legitimate (inject command
implementation, CHANGELOG history, CLI reference tables, test
fixtures for command detection).
Files updated:
- 11 core docs (context-packet, seed-definition, leverage-points, etc.)
- 7 workflow diagram docs (brief, system-map, cli-skills-map, HOOKS, etc.)
- 4 scripts (proof-run, test-flywheel, check-skill-flag-refs, etc.)
- 3 shell tests (proof-run e2e, token-budgets, no-compaction)
- 1 Go test (json_validity_test.go)
- Production code: metrics_nudge.go, metrics_flywheel.go, hooks.go
2026-03-07 11:59:18 -05:00
4fd2512c87
refactor: flatten CLI namespace and liquidate debt
...
Remove 5 namespace parent commands (know, work, quality, settings, start)
and register all 49 leaf commands directly on rootCmd. Flat namespace is
simpler for users; GroupID-based help provides visual grouping without
requiring namespace tokens.
Namespace flattening (184 files):
- Delete know.go, work.go, quality.go, settings.go, start.go
- Invert deprecatedCommands map (old namespace paths → flat paths)
- Update 127 consumer files (hooks, skills, docs, scripts, tests)
Debt liquidation (7 items from post-mortem):
- Fix 62 broken smoke test invocations
- Delete 118 LOC dead deprecatedAlias code
- Widen doctor scan to docs/, scripts/, and subdirectories
- Expand expectedCmds test to all 49 commands (floor 45)
- Add bidirectional expectedCmds sync check
- Create sweep-namespace-references.sh automation
- Fix EXPECTED_COMMANDS array to list flat commands
- Escape sed variables in sweep script
All Go tests pass (36s). All conformance checks pass.
2026-02-26 09:27:38 -05:00
a539546d33
codex installer: ship no-clone install flow and docs sync
2026-02-26 06:24:21 -05:00
bdf112ba7f
feat: align codex skill docs and hook command mappings
2026-02-26 05:48:41 -05:00
c665343d2c
fix: resolve 32 vibe findings (2 critical, 7 high, 12 medium, 11 low)
...
Fix all findings from the v2.17.0..HEAD vibe review across 12 source files:
Critical: panic guards for negative budget in truncateToCharBudget and
dead prefix slice in generateArtifactID. High: bead override in batch
extract, json file counting in metrics, constraint index.json exclusion,
complexity reduction in curate status/verify (38→<25), flexible hook
script count assertion. Medium: truncate panic guards, error logging for
silent failures, null→[] JSON output, goals auto-detect (GOALS.md then
GOALS.yaml), raw var→getter usage, truncate-before-lock race fix. Low:
scanner.Err() checks, os.Stdout→cmd.OutOrStdout(), dry-run output
differentiation.
Docs: 5 missing INDEX.md concept links, curation-pipeline v1 status
callout. Tests: new TestSeed_DryRun_JSON. Regen: COMMANDS.md, embedded
hooks synced. All gates pass: build, vet, test, gocyclo, heal, doc-gate.
2026-02-24 16:51:26 -05:00
ad12717607
feat(seed): Wave 3 — Meadows leverage points documentation
...
The Seed epic (ag-poz) Wave 3: theoretical foundation made explicit.
- docs/leverage-points.md: All 12 Meadows leverage points mapped to AgentOps
architecture, dK/dt equation mapping, #5→#4 emergence insight, 6th paradigm
shift (designed→evolved), ao metrics health ↔ LP #7-#8 connection, gap analysis
Full test suite passes (20 packages, 0 failures).
Closes: ag-poz.9, ag-poz.10
2026-02-24 12:40:40 -05:00
Bo