The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs: inventory legacy artifacts (#1787)
Affaan Mustafade559bddd220
diff --git a/docs/ECC-2.0-GA-ROADMAP.md b/docs/ECC-2.0-GA-ROADMAP.mdindex 6e29b4190..810551bd7 100644--- a/docs/ECC-2.0-GA-ROADMAP.md+++ b/docs/ECC-2.0-GA-ROADMAP.md@@ -30,6 +30,9 @@ As of 2026-05-12:- `docs/releases/2.0.0-rc.1/publication-readiness.md` gates GitHub release,npm dist-tag, Claude plugin, Codex plugin, OpenCode package, billing, andannouncement publication on fresh evidence fields.+- `docs/legacy-artifact-inventory.md` records that no `_legacy-documents-*`+ directories exist in the current checkout and classifies+ `legacy-command-shims/` as an opt-in archive/no-action surface.- AgentShield PR #53 reduced two context-rule false positives and closed theremaining AgentShield issues.- ECC PR #1778 recovered the useful stale #1413 network/homelab architect-agent@@ -189,7 +192,5 @@ Acceptance:AgentShield repo.2. Audit ECC Tools billing and check-run surfaces before any native GitHubpayments announcement.-3. Inventory `_legacy-documents-*` and map useful artifacts to landed,- milestone-tracked, salvage, or archive states.-4. Build the stale-PR salvage ledger from closed cleanup batches, then port+3. Build the stale-PR salvage ledger from closed cleanup batches, then portuseful pieces in small attributed maintainer PRs.diff --git a/docs/legacy-artifact-inventory.md b/docs/legacy-artifact-inventory.mdnew file mode 100644index 000000000..435c23d21--- /dev/null+++ b/docs/legacy-artifact-inventory.md@@ -0,0 +1,68 @@+# Legacy Artifact Inventory++This inventory keeps legacy and stale-work cleanup from becoming implicit. Each+artifact should be classified as landed, milestone-tracked, salvage branch, or+archive/no-action before release work treats the queue as clean.++## Classification States++| State | Meaning |+| --- | --- |+| Landed | Useful work has already been ported to current `main` and verified. |+| Milestone-tracked | Useful work remains, but belongs to a named roadmap milestone. |+| Salvage branch | Useful work should be ported through a fresh maintainer branch with attribution. |+| Translator/manual review | Content may be useful, but cannot be safely imported automatically. |+| Archive/no-action | Artifact is intentionally retained or skipped; no active port is planned. |++## Current Repository Scan++As of 2026-05-12, the tracked repo has no `_legacy-documents-*` directories.++Fresh check:++```sh+find . -type d -name '_legacy-documents-*' -print+```++Expected result: no output.++The only tracked legacy directory currently found by filename scan is+`legacy-command-shims/`.++## Inventory++| Artifact | State | Evidence | Action |+| --- | --- | --- | --- |+| `_legacy-documents-*` directories | Archive/no-action | No matching directories exist in the tracked checkout as of 2026-05-12. | Re-run the scan before release. If any appear, add each directory to this table before publishing. |+| `legacy-command-shims/` | Archive/no-action | `legacy-command-shims/README.md` states these retired short-name shims are opt-in and no longer loaded by the default plugin command surface. | Keep as an explicit compatibility archive. Do not move these back into the default plugin surface without a migration decision. |+| Closed-stale PR salvage ledger | Landed | `~/.cluster-swarm/handoffs/ecc-stale-salvage-ledger-20260512-0210.md` records useful stale work recovered through maintainer PRs. | Continue using the ledger pattern for future stale closures. |+| #1687 zh-CN localization tail | Translator/manual review | Large safe subsets landed in #1746-#1752; remaining pieces require translator/manual review per salvage ledger. | Do not blindly cherry-pick. Split by docs, commands, agents, and skills if a translator review lane opens. |++## Legacy Command Shim Contents++The compatibility archive currently contains 12 retired command shims:++| Shim | Preferred current direction |+| --- | --- |+| `agent-sort.md` | Use maintained command or skill routing where available. |+| `claw.md` | Use maintained `scripts/claw.js` / `npm run claw` surfaces. |+| `context-budget.md` | Use maintained token/context budgeting skills. |+| `devfleet.md` | Use maintained agent/harness orchestration docs and skills. |+| `docs.md` | Use current documentation and release checklist workflows. |+| `e2e.md` | Use maintained E2E testing skills and test scripts. |+| `eval.md` | Use eval-harness and verification-loop skills. |+| `orchestrate.md` | Use maintained orchestration status and worktree scripts. |+| `prompt-optimize.md` | Use prompt-optimizer skill. |+| `rules-distill.md` | Use current rules and skill extraction workflows. |+| `tdd.md` | Use tdd-workflow and language-specific testing skills. |+| `verify.md` | Use verification-loop and package-specific verification skills. |++## Release Rule++Before any GA or rc publication pass:++1. Re-run the `_legacy-documents-*` scan.+2. Re-run the closed-stale salvage ledger check.+3. Confirm every newly discovered legacy artifact is represented in this file.+4. Port useful work through fresh maintainer PRs with source attribution.+5. Leave archive/no-action artifacts out of default install and plugin loading.diff --git a/tests/docs/legacy-artifact-inventory.test.js b/tests/docs/legacy-artifact-inventory.test.jsnew file mode 100644index 000000000..ce706431f--- /dev/null+++ b/tests/docs/legacy-artifact-inventory.test.js@@ -0,0 +1,114 @@+'use strict';++const assert = require('assert');+const fs = require('fs');+const path = require('path');++const repoRoot = path.resolve(__dirname, '..', '..');+const legacyShimsDir = path.join(repoRoot, 'legacy-command-shims', 'commands');++let passed = 0;+let failed = 0;++function test(name, fn) {+ try {+ fn();+ console.log(` ✓ ${name}`);+ passed++;+ } catch (error) {+ console.log(` ✗ ${name}`);+ console.log(` Error: ${error.message}`);+ failed++;+ }+}++function read(relativePath) {+ return fs.readFileSync(path.join(repoRoot, relativePath), 'utf8');+}++function findLegacyDocumentDirs(dir) {+ const results = [];++ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {+ if (entry.name === 'node_modules' || entry.name === '.git') {+ continue;+ }++ const nextPath = path.join(dir, entry.name);++ if (!entry.isDirectory()) {+ continue;+ }++ if (entry.name.startsWith('_legacy-documents-')) {+ results.push(path.relative(repoRoot, nextPath));+ }++ results.push(...findLegacyDocumentDirs(nextPath));+ }++ return results.sort();+}++console.log('\n=== Testing legacy artifact inventory ===\n');++test('legacy artifact inventory documents classification states', () => {+ const source = read('docs/legacy-artifact-inventory.md');++ for (const state of [+ 'Landed',+ 'Milestone-tracked',+ 'Salvage branch',+ 'Translator/manual review',+ 'Archive/no-action',+ ]) {+ assert.ok(source.includes(state), `Missing classification state ${state}`);+ }+});++test('any _legacy-documents directories are explicitly inventoried', () => {+ const source = read('docs/legacy-artifact-inventory.md');+ const dirs = findLegacyDocumentDirs(repoRoot);++ for (const dir of dirs) {+ assert.ok(source.includes(dir), `Missing legacy artifact inventory row for ${dir}`);+ }+});++test('legacy command shims remain classified as an opt-in archive', () => {+ const source = read('docs/legacy-artifact-inventory.md');+ const readme = read('legacy-command-shims/README.md');++ assert.ok(source.includes('legacy-command-shims/'));+ assert.ok(source.includes('Archive/no-action'));+ assert.ok(readme.includes('no longer loaded by the default plugin command surface'));+ assert.ok(readme.includes('short-term migration compatibility'));+});++test('legacy command shim table tracks the current archive contents', () => {+ const source = read('docs/legacy-artifact-inventory.md');+ const shims = fs.readdirSync(legacyShimsDir)+ .filter(fileName => fileName.endsWith('.md'))+ .sort();++ assert.strictEqual(shims.length, 12);++ for (const shim of shims) {+ assert.ok(source.includes(`\`${shim}\``), `Missing legacy shim ${shim}`);+ }+});++test('stale salvage backlog records the remaining manual-review tail', () => {+ const source = read('docs/legacy-artifact-inventory.md');++ assert.ok(source.includes('#1687 zh-CN localization tail'));+ assert.ok(source.includes('Translator/manual review'));+ assert.ok(source.includes('#1746-#1752'));+});++if (failed > 0) {+ console.log(`\nFailed: ${failed}`);+ process.exit(1);+}++console.log(`\nPassed: ${passed}`);