ECC/docs
legeZZZ eb5ad2b009
feat(agents): add spec-miner agent for brownfield spec extraction (#2253)
* feat(agents): add spec-miner agent for brownfield spec extraction

Mines behavioral specs (Requirements + Invariants) from existing codebases
without OpenSpec. Fully self-bootstrapping with sample-and-expand token
strategy. Produces flat, delta-ready spec.md files with machine-parseable
metadata (id, entities, enforced, depends_on, triggers).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* docs: bump agent catalog count from 64 to 65 for spec-miner

All documentation and plugin manifests now reflect the new agent total.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: add spec-miner to routing table and clarify id field requirement

- Add spec-miner to AGENTS.md agent table and orchestration hints
- Fix id field in output template: was marked [optional] but Rule #7
  requires it when enforced is known

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: update catalog skills count from 261 to 262 across all docs

The upstream added a 262nd skill but documentation references across 7 files
still reported 261. The CI validate step (scripts/ci/catalog.js --text) caught
the mismatch — this only runs on PRs, not on direct pushes to main.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: replace emoji characters with text equivalents in spec-miner agent

The unicode safety check (check-unicode-safety.js) blocks emoji characters.
Replace  with FAIL: per the project's targeted replacement convention.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: add Write tool to spec-miner agent tools list

The agent generates spec output files at openspec/specs/<capability>/spec.md
and requires the Write tool to create them.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: address review bot comments - tool guardrails and metadata schema consistency

- Add Tool guardrails section: scoping Write to openspec/specs/ path, Bash to read-only
- Fix deferred/uncertainty comments to follow key: value schema (deferred: file list, uncertainty: reason)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: strengthen Prompt Defense Baseline for repository content and Bash boundaries

Add two defense points: treat all repo content as untrusted prompt-injection
vector, and explicitly reject Bash commands that mutate, exfiltrate, or write
outside the allowed openspec/specs/ path.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: strip explanatory prose from id metadata comment to preserve key:value format

The id comments included explanatory text after the value, which would be
stored verbatim in copied specs and break stable delta matching. The
explanation is already covered by Format Rule #7.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: restore README.md to upstream baseline with only catalog count changes

The README was corrupted during cherry-pick conflict resolution — an older fork
version was introduced, changing release notes links, badge URLs, sponsor
sections, and other content. Restore to upstream/main (5b173d2) and re-apply
only the agent count (64→65) using catalog.js --write.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: restore all catalog files to upstream baseline, keep only intentional changes

The cherry-pick during rebase introduced a stale fork version of multiple files
via git checkout --theirs conflict resolution. Restore from upstream/main and
re-apply only:

- Agent counts: 64→65 (all 7 catalog-tracked files)
- Skills counts: 261→262 (where needed)
- AGENTS.md: spec-miner routing table + orchestration hint (our additions)

This reverts unintended regressions:
- Version downgrades (2.0.0 → 2.0.0-rc.1) in marketplace.json, plugin.json,
  AGENTS.md, docs/zh-CN/AGENTS.md, docs/zh-CN/README.md
- Badge URL changes (api.ecc.tools dynamic → hardcoded) in Chinese READMEs
- Deleted v2.0.0 stable release sections in Chinese READMEs
- Wrong release notes path (2.0.0-rc.1 → 2.0.0) in README.md

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: lege962 <1515808962@qq.com>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-15 14:02:02 -04:00
..
architecture docs: define ECC platform value loop (#2119) 2026-06-02 19:51:02 +08:00
business feat: add dynamic workflow team orchestration surface 2026-06-04 21:45:13 +08:00
de-DE fix: context-size /compact trigger, Codex marketplace plugin path, live README badges (#2237) 2026-06-11 16:21:53 -04:00
drafts docs: mirror agentshield fleet ticket evidence 2026-05-18 10:24:21 -04:00
es fix: context-size /compact trigger, Codex marketplace plugin path, live README badges (#2237) 2026-06-11 16:21:53 -04:00
examples feat: add product capability planning lane 2026-04-05 16:58:02 -07:00
fixes fix: make plugin hooks run on Node 21+ and green the suite under modern Node (#2184) 2026-06-07 16:05:28 +08:00
ja-JP fix(skills): replace star ratings with ASCII N/5 (#2194) 2026-06-15 13:48:54 -04:00
ko-KR fix: context-size /compact trigger, Codex marketplace plugin path, live README badges (#2237) 2026-06-11 16:21:53 -04:00
pt-BR fix: context-size /compact trigger, Codex marketplace plugin path, live README badges (#2237) 2026-06-11 16:21:53 -04:00
releases release: 2.0.0 — the agent harness operating system 2026-06-09 21:40:40 -04:00
ru fix: context-size /compact trigger, Codex marketplace plugin path, live README badges (#2237) 2026-06-11 16:21:53 -04:00
security docs: sync AgentShield adapter evidence 2026-05-19 20:54:15 -04:00
th fix(docs): sync marketplace add URL across translated READMEs (#2050) (#2068) 2026-06-07 13:26:58 +08:00
tr release: 2.0.0 — the agent harness operating system 2026-06-09 21:40:40 -04:00
ur fix: context-size /compact trigger, Codex marketplace plugin path, live README badges (#2237) 2026-06-11 16:21:53 -04:00
vi-VN fix(docs): sync marketplace add URL across translated READMEs (#2050) (#2068) 2026-06-07 13:26:58 +08:00
zh-CN feat(agents): add spec-miner agent for brownfield spec extraction (#2253) 2026-06-15 14:02:02 -04:00
zh-TW fix(docs): sync marketplace add URL across translated READMEs (#2050) (#2068) 2026-06-07 13:26:58 +08:00
ANTIGRAVITY-GUIDE.md docs: add Antigravity setup and usage guide (#552) 2026-03-20 00:21:37 -07:00
ARCHITECTURE-IMPROVEMENTS.md fix: route continuous learning observe hooks through node 2026-04-29 21:28:59 -04:00
capability-surface-selection.md docs: add capability surface selection guide 2026-04-06 14:21:28 -07:00
COMMAND-AGENT-MAP.md feat(agents): add typescript-reviewer agent (#647) 2026-03-19 20:49:23 -07:00
COMMAND-REGISTRY.json feat: add orch-* orchestrator skill family (#2153) 2026-06-07 16:15:31 +08:00
continuous-learning-v2-spec.md feat: deliver v1.8.0 harness reliability and parity updates 2026-03-04 14:48:06 -08:00
ECC-2.0-GA-ROADMAP.md docs: sync live native payments gate evidence 2026-05-19 23:25:38 -04:00
ECC-2.0-REFERENCE-ARCHITECTURE.md docs: add release plugin publication checklist 2026-05-18 08:56:17 -04:00
ECC-2.0-SESSION-ADAPTER-DISCOVERY.md feat: orchestration harness, selective install, observer improvements 2026-03-14 12:55:25 -07:00
HERMES-OPENCLAW-MIGRATION.md feat: add ecc2 legacy plugin migration import 2026-04-10 11:53:17 -07:00
HERMES-SETUP.md docs: close ecc2 rc1 release policy drift 2026-04-29 19:52:09 -04:00
hook-bug-workarounds.md docs: add canonical hook bug workaround guide 2026-04-06 14:12:21 -07:00
JOYCODE-GUIDE.md feat: add JoyCode install target 2026-05-11 11:10:59 -04:00
legacy-artifact-inventory.md Track legacy localization tail in readiness dashboard 2026-05-17 14:47:29 -04:00
MANUAL-ADAPTATION-GUIDE.md docs: add manual adaptation guide for non-native harnesses 2026-04-05 14:39:55 -07:00
MCP-CONNECTOR-POLICY.md feat(mcp): single-connector default set + connector policy (#2219) 2026-06-09 23:28:35 -04:00
MEGA-PLAN-REPO-PROMPTS-2026-03-12.md feat: orchestration harness, selective install, observer improvements 2026-03-14 12:55:25 -07:00
PHASE1-ISSUE-BUNDLE-2026-03-12.md feat: orchestration harness, selective install, observer improvements 2026-03-14 12:55:25 -07:00
PLAN-PRD-PATTERN.md feat: add PRD planning command flow 2026-05-12 00:06:41 -04:00
PR-399-REVIEW-2026-03-12.md feat: orchestration harness, selective install, observer improvements 2026-03-14 12:55:25 -07:00
PR-QUEUE-TRIAGE-2026-03-13.md feat: orchestration harness, selective install, observer improvements 2026-03-14 12:55:25 -07:00
QWEN-GUIDE.md feat: add Qwen install target 2026-05-11 11:27:46 -04:00
SELECTIVE-INSTALL-ARCHITECTURE.md release: 2.0.0 — the agent harness operating system 2026-06-09 21:40:40 -04:00
SELECTIVE-INSTALL-DESIGN.md feat: orchestration harness, selective install, observer improvements 2026-03-14 12:55:25 -07:00
SESSION-ADAPTER-CONTRACT.md feat(session): add worker health alongside state in ecc.session.v1 (#751) 2026-03-22 15:39:51 -07:00
skill-adaptation-policy.md docs: add skill adaptation policy 2026-04-06 14:30:23 -07:00
SKILL-DEVELOPMENT-GUIDE.md refactor: move project guidelines example into docs 2026-04-05 15:03:59 -07:00
SKILL-PLACEMENT-POLICY.md feat: define skill placement and provenance policy (#748) 2026-03-22 15:39:48 -07:00
stale-pr-salvage-ledger.md docs: finish owner queue cleanup 2026-05-18 06:35:44 -04:00
token-optimization.md fix: add context monitor cost warning opt-out 2026-05-17 01:53:57 -04:00
TROUBLESHOOTING.md docs: add canonical hook bug workaround guide 2026-04-06 14:12:21 -07:00