Commit Graph

34 Commits

Author SHA1 Message Date
Bo 6d5d111faf feat(skills): land four-vendor skill corpus (#803)
## Summary
- Lands the AgentOps skill corpus across source and Codex wrappers,
including Gemini image targets.
- Integrates the skill branch onto current origin/main and refreshes
generated manifests/catalogs.
- Normalizes local next-work queue enum drift and fixes shellcheck in
alias-collision validation.

## Validation
- bash scripts/regen-all.sh --check
- bash scripts/validate-skill-schema.sh
- bash tests/skills/test-token-budgets.sh
- bash tests/skills/run-all.sh
- bash scripts/audit-codex-parity.sh && bash
scripts/validate-codex-override-coverage.sh && bash
scripts/validate-codex-generated-artifacts.sh --scope worktree && bash
scripts/validate-codex-api-conformance.sh && bash
scripts/validate-codex-runtime-sections.sh && bash
scripts/lint-codex-native.sh
- bash skills/heal-skill/scripts/heal.sh --strict
- PRE_PUSH_SKIP_MKDOCS=1 bash scripts/pre-push-gate.sh --fast

MkDocs strict remains skipped locally via the documented
PRE_PUSH_SKIP_MKDOCS=1 override because the repo currently emits
repo-wide strict-link warnings unrelated to this landing; CI remains
authoritative.
2026-06-06 23:44:42 -04:00
Bo c1a46cee26 chore: scrub all jsm references — external ref only, patterns kept (soc-wnic7 #scrub-jsm) (#501)
## What

Operator directive (soc-wnic7): scrub ALL references to "jsm" from
AgentOps. jsm was only an external reference corpus we learned patterns
from. The absorbed **patterns stay** (skill-quality rubric, SELF-TEST
shape, system-tuning methodology, bug-hunt patterns, attribution
patterns, marketplace-export profile) — only the jsm **name**,
jsm-dedicated docs, and jsm export tooling are removed.

## Deleted (8 files)

- `docs/reference/jsm-agentops-gap-audit.md`
- `docs/reference/jsm-clean-room-extraction-policy.md`
- `docs/reference/jsm-cli-capability-map.md`
- `docs/reference/jsm-pilot-upgrade-backlog.md`
- `docs/reference/jsm-skill-absorption.md`
- `docs/reference/jsm-skill-standards.md`
- `scripts/check-jsm-export.sh`
- `scripts/inventory-jsm-skills.sh`

## Renamed (kept methodology, stripped jsm)

`skills/standards/references/jsm-attribution.md` →
`external-source-attribution.md` (+ skills-codex + cli/embedded
mirrors). The attribution methodology (Pattern A/B, choice rule, mkdocs
constraint, clean-room hygiene) is a kept pattern — renamed and de-named
rather than deleted, so the standards skill keeps a repoint target.

## Edited

- De-catalogued the 6 deleted docs from `docs/documentation-index.md`
and `docs/reference/index.md`; de-named the kept skill-quality-rubric
entries.
- Genericized every footer/credit per the scope rule:
- `Adapted from jsm / \`x\`` → `Adapted from an external skill corpus /
\`x\``
- `(jsm/ACFS skill corpus)` → `(ACFS skill corpus)` — **ACFS/gstack
credits left intact**
- jsm-only credits (system-tuning, hooks-authoring) → "external skill
corpus", keeping the methodology-only/no-verbatim hygiene clause
- Genericized: "JSM-Style/Marketplace Export Profile", hexagonal-map
adapter node, domain-evolution BDD/plan gherkin steps, CHANGELOG
entries, skill-auditor validation-terms tuple.
- Removed dead `check-jsm-export` blocks from 4 SELF-TEST.md files.

## Regen + gates (all green)

`make sync-hooks` · `regen-codex-hashes.sh` · `generate-registry.sh`
re-run. Verified: `grep -ri jsm` empty (per exclusions);
`regen-codex-hashes --check` OK; `generate-registry --check` OK;
`validate-embedded-sync` in sync; `validate-context-map-drift` OK;
`check-docs-learning-references` PASS; `heal.sh --strict` clean;
`audit-codex-parity` PASS; `go build ./...` OK; no dangling punctuation;
no broken links to deleted files.

Closes-scenario: soc-wnic7#scrub-jsm
Bounded-context: BC1-Corpus
Evidence: docs/documentation-index.md
2026-05-23 22:41:56 -04:00
Bo ebd5c50962 feat(skills): add canonical .feature acceptance to 5 skills — batch 4, completes crank tail (soc-qk4b #crank-batch4) (#479)
W2 of the 3.0 reconciliation — **final hexagon crank batch**. **71/80
skills now carry a .feature.** No behavior/frontmatter change.

| Skill | Acceptance added |
|---|---|
| codex-team | disjoint file-target analysis, conflict-free spawn, join
before reap |
| curate | resolve mode+scope, lock on shared writes, synthesis + bd
notes |
| dream | resolve lane, bounded bedtime loop, write report |
| grafana-platform-dashboard | scope+IA from contracts, library queries,
validate-before-apply, verify sync |
| reverse-engineer-rpi | repo feature-catalog/code-map, binary security
audit, durable specs |

**The 9 skills without a .feature are intentionally exempt** (not crank
targets): expert-council + inject (deprecated/removal-target); shared,
standards, using-agentops, converter, provenance, flywheel
(meta/internal/not user-invocable); llm-wiki (open proposal, no
implementation — a .feature would assert unbuilt behavior). Enumerated +
justified in W4's level-set.

Gates: registry --check OK; codex-parity ✓×5; heal --strict clean ×5;
check-skill-size 0/0.

NOTE: claude-review infra-red (weekly limit, resets May 25) —
operator-authorized bypass when sole red.

Closes-scenario: soc-qk4b#crank-batch4
Bounded-context: BC1-Corpus
Evidence: skills/codex-team/references/codex-team.feature
2026-05-23 16:58:23 -04:00
Boden Fuller b8c5a3761b feat(agentops): make 3.0 hookless-first
Add DDD skill-domain contracts, hook lease inventory, replacement ports, artifact-first RPI skill boundaries, and release exact-SHA validation. Demote ao inject to a compatibility adapter and remove prompt-only default hooks.
2026-05-16 09:43:08 -04:00
Boden Fuller 8c731aef64 fix(ci): make skill validate-contracts billboard-aware (clears 4 CI failures)
#275's billboard refactor thinned process-skill SKILL.md files and moved
detail into references/, but the validate contracts still grepped SKILL.md.

skill-lint + smoke-test: relax content-presence checks in crank/implement/
  post-mortem/swarm validate.sh to scan the skill as a unit (SKILL.md +
  references/); structural/identity checks stay SKILL.md-only. test-first-smoke
  updated to match relocated SPEC/TEST WAVE + Step 0/4 headings.
skill-lint line caps: trim flywheel 310 -> 286 (cap 300), using-agentops
  261 -> 239 (cap 250) by removing redundant prose, no content lost.
skill-integrity: link 3 orphaned references (crank/branch-isolation,
  validation/flags + release-readiness-gates).
codex parity: regenerate stale skills-codex source hashes (77 skills).

Local: run-all.sh PASS, heal.sh --strict clean, smoke-test PASS.
2026-05-15 16:30:32 -04:00
Boden Fuller b4927fcbee feat(practice): pass-3 backfill — 13 more practices: declarations + harvest
Adds practices: frontmatter to 13 next-batch skills: autodev, beads, bootstrap,
codex-team, compile, converter, deps, doc, dream, evolve, grafana-platform-dashboard,
heal-skill, hooks-authoring.

scripts/validate-practice-citations.sh:
  with practices field: 39 (was 26)
  missing practices field: 715 (was 728)
  invalid slug citations: 0

Pass-1 + pass-2 learnings applied: schema accepts practices, codex twins
untouched, .agents/ session artifacts not committed. next-work appended with
pass-4 candidates (uses valid post-mortem-finding source enum).

Local pre-push fast gate: green.

🤖 Generated via /evolve cycle 1.
2026-05-10 20:40:18 -04:00
Boden Fuller b6e03c710d feat(skills): absorb remaining JSM slices 2026-05-05 09:03:19 -04:00
Boden Fuller a7a51f2c16 feat(standards): codify skill tier caps and codex registration 2026-05-03 23:00:11 -04:00
Boden Fuller 5f620dcf34 docs(codex-spawn): mirror env-var bypass across skill references
Update all user-facing examples and reference templates so agents copying
canonical invocations get the AGENTOPS_INTENT_ECHO_DISABLED=1 prefix.
Substrate fix landed in 55ded76d (lib/scripts/team-runner.sh + scripts +
tests); this commit covers the doc surface so individual skills that
shell out to codex exec directly (instead of through team-runner) also
ship the bypass.

Updated:
- skills/codex-team/SKILL.md (~13 invocations) and skills-codex/ mirror
- skills-codex-overrides/council/SKILL.md (--mixed example)
- skills/{swarm,research}/references/backend-codex-subagents.md and codex mirrors
- skills/SKILL-TIERS.md canonical command + example
- skills/standards/references/codex-skill.md, codex mirror, embedded copy

Regenerated codex parity hashes for codex-team, research, standards,
swarm. audit-codex-parity passes for council, codex-team, swarm,
research, standards.

See .agents/findings/registry.jsonl f-2026-05-02-002 / f-2026-05-02-003.
2026-05-02 12:38:19 -04:00
Boden Fuller 557e4af9ec feat(codex): cap skills-codex description catalog and add --repair-shape audit
Adds a 2400-char aggregate budget for skills-codex/*/SKILL.md `description:`
fields in tests/skills/test-token-budgets.sh, then trims each skill's description
to fit (catalog now 2146/2400). Both Claude and Codex SKILL.md descriptions
are kept in sync; codex .agentops-generated.json hashes regenerated.

Adds --repair-shape to scripts/audit-codex-hooks.sh: when ~/.codex/hooks.json
is missing or in legacy-flat shape, rewrites it from hooks/codex-hooks.json
with the active plugin_root (read from .agentops-codex-install.json) and
backs up any prior file. Covered by new test_repairs_legacy_flat_shape.

Memory decay (4 .agents/ files) bumped by the SessionStart inject hook.
2026-04-30 15:16:59 -04:00
Boden Fuller fc863c9d9f Refresh Codex skills for GPT-5.5 2026-04-24 21:56:40 -04:00
Boden Fuller 0496441989 Reduce skill catalog context footprint 2026-04-24 00:52:27 -04:00
Boden Fuller 98e581989c codex: retire stale artifact provenance metadata 2026-04-01 13:10:42 -04:00
Boden Fuller 3f6bb2bda4 chore(codex): sync Codex skills for 6 new lifecycle skills
Add Codex variants (SKILL.md, prompt.md, markers) for test, review,
refactor, deps, perf, and scaffold. Wire cross-references in 8 existing
Codex skill copies. Update catalog and manifest.
2026-03-27 19:39:12 -04:00
Boshu2 fea2b6a300 fix(codex): revert auto-copy of Claude-primitive references to skills-codex
The regen-codex-hashes.sh auto-copy feature copied reference files
containing Claude-specific primitives (TeamCreate, backend-claude-teams)
into codex skills, causing parity audit failures. Revert the script
change and remove all auto-copied files. Keep only the reviewer-config
example that was intentionally created.
2026-03-21 16:45:27 -04:00
Boshu2 401a80310c feat(skills): post-mortem quick wins from competitive integration
- Auto-copy references to skills-codex in regen-codex-hashes.sh
- Add line-count check and codex parity step to plan template
- Add --fast-path flag to plan Flags table
- Create reviewer-config-example.md for council
- Major rewrite of vs-gsd.md (GSD v1.27 is no longer lightweight)
- Moderate update of vs-compound-engineer.md (ideation, refresh, 10 runtimes)
2026-03-21 16:40:32 -04:00
Boden Fuller b5316baef7 fix: align codex skill bundle with runtime contract 2026-03-21 10:08:27 -04:00
Boshu2 7d5162591b fix: harden codex runtime skill parity 2026-03-18 16:19:51 -04:00
Boshu2 8e59cf1389 fix(skills-codex): audit + fix 60+ findings, strengthen CI gates
Skills content fixes:
- Add metadata.tier to all 54 skills-codex/ frontmatter
- Fix wrong-directory cross-refs in 11 skills (skills/ → ../)
- Remove Claude primitive leakage from 13 skills (TaskCreate,
  AskUserQuestion, read_file, Agent tool, claude-code-latest-features)
- Fix dead refs, link missing references, remove orphaned Claude files
- Fix malformed ..$X link syntax in brainstorm, codex-team, rpi, validation
- Minor skills/ fixes: release refs, using-agentops count, push sections

CI gate hardening (false-pass elimination):
- heal.sh: scan skills-codex/, add MISSING_TIER/MALFORMED_LINK/DUPLICATE_REF
- audit-codex-parity.py: +7 Claude primitive patterns, +WRONG_XREF_DIR
- validate-links.sh: add skills-codex/ to scan scope (726 → 1117 links)
- validate-codex-generated-artifacts.sh: frontmatter check, invoke audit
2026-03-15 13:51:49 -04:00
Boshu2 1332005911 fix(converter): strip task primitives instead of mapping to unavailable tools
todo_write and update_plan are NOT available as Codex tools (empirically
verified via codex exec). Previous mapping was wrong — now strips all
Task*/Team*/SendMessage lines instead.

Also:
- Add Skill(skill="X") → $X rewrite rule
- Add Skill() invocation check to conformance validator
- Update contract doc with corrected mapping table
- Regen all 54 codex skills: 0 conformance failures, 0 SKILL.md primitives
2026-03-14 10:01:36 -04:00
Boshu2 f41e6d6a5a fix(converter): rewrite reference files through codex_rewrite_text
Reference .md files in skills-codex/ were copied verbatim from source,
bypassing all converter rewrite rules. Now .md files in references/,
scripts/, and other subdirs are processed through codex_rewrite_text()
during passthrough copy.

Empirically validated: Codex agent confirms 0 Claude primitives in
converted reference files (was 107). Remaining gap: crank/swarm
orchestration patterns need full Codex-native rewrites (not converter
fixes) — tracked separately.

Validated with: codex exec -s read-only (gpt-5.4)
2026-03-14 03:29:04 -04:00
Boshu2 62ce8b0d1c feat(skills): ag-wug epic + codex converter parity regen
- Add output_contract, effort tables, sparse checkout guidance to skills
- Update claude-code-latest-features.md across all skills
- Regenerate all 54 codex skills with improved converter rules
- Codex parity: 107 → 8 findings (92% reduction)
2026-03-14 02:27:59 -04:00
Boshu2 69ef1cb632 fix(ci): sync skills-codex, trim oversized skills, fix tuning tests
- Regenerate skills-codex with discovery and validation directories
- Add discovery/validation to codex-overrides catalog
- Trim discovery SKILL.md (276→215) and rpi SKILL.md (261→243) under
  250-line limit by extracting content to references/
- Add complexity-scaled council gates to rpi SKILL.md (fixes T14-T16, T32)
- Add required section headings to rpi SKILL.md (fixes validate.sh)
- Regenerate CLI docs for --auto-extract description change
2026-03-10 14:47:12 -04:00
Boshu2 140b4ce0ba fix(skills): mirror runtime reference packs 2026-03-10 07:53:09 -04:00
Boshu2 409ff8afda fix(skills): restore localized codex reference bundle 2026-03-10 07:49:47 -04:00
Boshu2 50c96a6d2b fix(skills): localize runtime reference packs 2026-03-10 07:44:59 -04:00
Boshu2 d01aa1e894 chore: sync codex bundle after merge 2026-03-09 21:41:07 -04:00
Test d41fa027da docs: default codex-team to user model 2026-03-09 13:00:42 -04:00
Test c25b6b32c9 fix(codex): sync override-generated prompts 2026-03-08 18:48:25 -04:00
Boden Fuller 9205270833 Harden local codex skill validation 2026-03-07 13:26:49 -05:00
Boden Fuller 96b62f20fb chore: stage council V2 contract wiring and skill-codex updates
Wire 6-judge analytics recommendations into skill contracts, add push
skill, sync embedded hooks, and update docs/product metadata.
2026-03-02 06:48:56 -05:00
Boden Fuller b91c4428a1 Release v2.19.0 2026-02-26 23:21:18 -05:00
Boden Fuller 7d65010131 chore: regenerate codex-native skills (modular layout, 49 skills)
Generated by sync-codex-native-skills.sh with modular layout.
References and scripts copied as files instead of inlined.
Overrides applied for 9 skills. Parity validated: 49/49.
2026-02-26 11:02:17 -05:00
Boden Fuller ab8df91ced feat(codex): add Codex-native skill format and install/sync scripts
- skills-codex/: 53 skills converted to Codex-native agents.md format
- install-codex-native-skills.sh: install to ~/.codex/agents/
- sync-codex-native-skills.sh: sync from source skills/ to skills-codex/
- test-codex-native-install.sh: integration tests for the install pipeline
2026-02-25 08:44:19 -05:00