From 652f6a2df23b693e319231a6ef839ac35ed9838d Mon Sep 17 00:00:00 2001 From: cyre Date: Wed, 29 Jul 2026 00:19:07 +0000 Subject: [PATCH] feat: harmonize ECC workflow-pack onto current merged (PR #21 synthesis) --- .agents/skills/periscope/SKILL.md | 3 + ...dd-or-update-backend-feature-with-tests.md | 41 ++++++++++++ .../documentation-and-blueprint-update.md | 37 ++++++++++ ...nd-component-update-with-i18n-and-tests.md | 38 +++++++++++ .claude/ecc-tools.json | 67 +++++++++++++------ .../inherited/periscope-instincts.yaml | 1 + .claude/skills/periscope/SKILL.md | 3 + 7 files changed, 171 insertions(+), 19 deletions(-) create mode 100644 .claude/commands/add-or-update-backend-feature-with-tests.md create mode 100644 .claude/commands/documentation-and-blueprint-update.md create mode 100644 .claude/commands/frontend-component-update-with-i18n-and-tests.md diff --git a/.agents/skills/periscope/SKILL.md b/.agents/skills/periscope/SKILL.md index 83661ceb0..ffca8e6cb 100644 --- a/.agents/skills/periscope/SKILL.md +++ b/.agents/skills/periscope/SKILL.md @@ -232,3 +232,6 @@ and handoff notes before expanding scope. | `/database-migration` | `.claude/commands/database-migration.md` | | `/feature-development` | `.claude/commands/feature-development.md` | | `/refactoring` | `.claude/commands/refactoring.md` | +| `/add-or-update-backend-feature-with-tests` | `.claude/commands/add-or-update-backend-feature-with-tests.md` | +| `/frontend-component-update-with-i18n-and-tests` | `.claude/commands/frontend-component-update-with-i18n-and-tests.md` | +| `/documentation-and-blueprint-update` | `.claude/commands/documentation-and-blueprint-update.md` | diff --git a/.claude/commands/add-or-update-backend-feature-with-tests.md b/.claude/commands/add-or-update-backend-feature-with-tests.md new file mode 100644 index 000000000..3549616bd --- /dev/null +++ b/.claude/commands/add-or-update-backend-feature-with-tests.md @@ -0,0 +1,41 @@ +--- +name: add-or-update-backend-feature-with-tests +description: Workflow command scaffold for add-or-update-backend-feature-with-tests in periscope. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /add-or-update-backend-feature-with-tests + +Use this workflow when working on **add-or-update-backend-feature-with-tests** in `periscope`. + +## Goal + +Implements or refactors backend features, always accompanied by corresponding test files. Typically involves Go source files and their _test.go counterparts in cmd/periscope/ or internal/ directories. + +## Common Files + +- `cmd/periscope/*.go` +- `cmd/periscope/*_test.go` +- `internal/**/*.go` +- `internal/**/*_test.go` +- `Makefile` +- `go.mod` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Edit or create Go implementation file in cmd/periscope/ or internal/ directories +- Edit or create corresponding _test.go file for tests +- Update Makefile or go.mod/go.sum if dependencies or build steps change +- Run tests to verify changes + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file diff --git a/.claude/commands/documentation-and-blueprint-update.md b/.claude/commands/documentation-and-blueprint-update.md new file mode 100644 index 000000000..70e0e5137 --- /dev/null +++ b/.claude/commands/documentation-and-blueprint-update.md @@ -0,0 +1,37 @@ +--- +name: documentation-and-blueprint-update +description: Workflow command scaffold for documentation-and-blueprint-update in periscope. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /documentation-and-blueprint-update + +Use this workflow when working on **documentation-and-blueprint-update** in `periscope`. + +## Goal + +Updates or adds documentation, blueprints, or architecture plans, often in docs/ or scripts/guides/ directories. + +## Common Files + +- `docs/**/*.md` +- `docs/guides/**/*.md` +- `docs/superpowers/**/*.md` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Edit or create markdown files in docs/ or docs/guides/ +- Optionally update related scripts or blueprints +- Commit with a message referencing documentation or blueprint + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file diff --git a/.claude/commands/frontend-component-update-with-i18n-and-tests.md b/.claude/commands/frontend-component-update-with-i18n-and-tests.md new file mode 100644 index 000000000..03aef7894 --- /dev/null +++ b/.claude/commands/frontend-component-update-with-i18n-and-tests.md @@ -0,0 +1,38 @@ +--- +name: frontend-component-update-with-i18n-and-tests +description: Workflow command scaffold for frontend-component-update-with-i18n-and-tests in periscope. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /frontend-component-update-with-i18n-and-tests + +Use this workflow when working on **frontend-component-update-with-i18n-and-tests** in `periscope`. + +## Goal + +Adds or updates a frontend Svelte component, updates internationalization files, and adds or updates corresponding tests. + +## Common Files + +- `frontend/src/lib/components/**/*.svelte` +- `frontend/src/lib/components/**/*.test.ts` +- `frontend/messages/*.json` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Edit or create .svelte component in frontend/src/lib/components/ +- Edit or create corresponding .test.ts file for the component +- Update i18n message files (frontend/messages/*.json) for localization +- Update other related frontend files if needed + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file diff --git a/.claude/ecc-tools.json b/.claude/ecc-tools.json index 027d8c260..d516c355d 100644 --- a/.claude/ecc-tools.json +++ b/.claude/ecc-tools.json @@ -5,8 +5,8 @@ "generatedAt": "2026-07-28T14:38:14.771Z", "repo": "https://github.com/diazMelgarejo/periscope", "referenceSetReadiness": { - "score": 29, - "present": 2, + "score": 43, + "present": 3, "total": 7, "items": [ { @@ -19,8 +19,10 @@ { "id": "rag-evaluator", "label": "RAG/evaluator comparison", - "status": "missing", - "evidence": [], + "status": "present", + "evidence": [ + "frontend/src/lib/storage/local-storage-key.test.ts" + ], "recommendation": "Add retrieval or evaluator reference-set comparison fixtures with expected ranking behavior." }, { @@ -42,9 +44,9 @@ "label": "Harness compatibility", "status": "present", "evidence": [ - ".agents/skills/localization-paraglide/SKILL.md", - ".agents/skills/localization-paraglide/agents/openai.yaml", - ".agents/skills/localization-paraglide/references/paraglide-formatting.md" + ".agents/skills/periscope/SKILL.md", + ".agents/skills/periscope/agents/openai.yaml", + ".claude/ecc-tools.json" ], "recommendation": "Add cross-harness, adapter-compliance, or harness-audit evidence for Claude, Codex, OpenCode, Zed, dmux, and agent surfaces." }, @@ -53,8 +55,8 @@ "label": "Security evidence", "status": "present", "evidence": [ - "SECURITY.md", - "scripts/git/audit_attribution.sh" + "scripts/git/audit_attribution.sh", + "scripts/git/audit_engine.py" ], "recommendation": "Attach security evidence such as SBOMs, SARIF, audit reports, or AgentShield evidence packs." }, @@ -184,7 +186,10 @@ ".claude/homunculus/instincts/inherited/periscope-instincts.yaml", ".claude/commands/database-migration.md", ".claude/commands/feature-development.md", - ".claude/commands/refactoring.md" + ".claude/commands/refactoring.md", + ".claude/commands/add-or-update-backend-feature-with-tests.md", + ".claude/commands/frontend-component-update-with-i18n-and-tests.md", + ".claude/commands/documentation-and-blueprint-update.md" ], "packageFiles": { "runtime-core": [ @@ -202,7 +207,10 @@ "workflow-pack": [ ".claude/commands/database-migration.md", ".claude/commands/feature-development.md", - ".claude/commands/refactoring.md" + ".claude/commands/refactoring.md", + ".claude/commands/add-or-update-backend-feature-with-tests.md", + ".claude/commands/frontend-component-update-with-i18n-and-tests.md", + ".claude/commands/documentation-and-blueprint-update.md" ] }, "moduleFiles": { @@ -221,7 +229,10 @@ "workflow-pack": [ ".claude/commands/database-migration.md", ".claude/commands/feature-development.md", - ".claude/commands/refactoring.md" + ".claude/commands/refactoring.md", + ".claude/commands/add-or-update-backend-feature-with-tests.md", + ".claude/commands/frontend-component-update-with-i18n-and-tests.md", + ".claude/commands/documentation-and-blueprint-update.md" ] }, "files": [ @@ -289,20 +300,35 @@ "moduleId": "workflow-pack", "path": ".claude/commands/refactoring.md", "description": "Workflow command scaffold for refactoring." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/add-or-update-backend-feature-with-tests.md", + "description": "Workflow command scaffold for add-or-update-backend-feature-with-tests." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/frontend-component-update-with-i18n-and-tests.md", + "description": "Workflow command scaffold for frontend-component-update-with-i18n-and-tests." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/documentation-and-blueprint-update.md", + "description": "Workflow command scaffold for documentation-and-blueprint-update." } ], "workflows": [ { - "command": "database-migration", - "path": ".claude/commands/database-migration.md" + "command": "add-or-update-backend-feature-with-tests", + "path": ".claude/commands/add-or-update-backend-feature-with-tests.md" }, { - "command": "feature-development", - "path": ".claude/commands/feature-development.md" + "command": "frontend-component-update-with-i18n-and-tests", + "path": ".claude/commands/frontend-component-update-with-i18n-and-tests.md" }, { - "command": "refactoring", - "path": ".claude/commands/refactoring.md" + "command": "documentation-and-blueprint-update", + "path": ".claude/commands/documentation-and-blueprint-update.md" } ], "adapters": { @@ -312,7 +338,10 @@ "commandPaths": [ ".claude/commands/database-migration.md", ".claude/commands/feature-development.md", - ".claude/commands/refactoring.md" + ".claude/commands/refactoring.md", + ".claude/commands/add-or-update-backend-feature-with-tests.md", + ".claude/commands/frontend-component-update-with-i18n-and-tests.md", + ".claude/commands/documentation-and-blueprint-update.md" ] }, "codex": { diff --git a/.claude/homunculus/instincts/inherited/periscope-instincts.yaml b/.claude/homunculus/instincts/inherited/periscope-instincts.yaml index deb6e3461..a2867c648 100644 --- a/.claude/homunculus/instincts/inherited/periscope-instincts.yaml +++ b/.claude/homunculus/instincts/inherited/periscope-instincts.yaml @@ -2,6 +2,7 @@ # Generated: 2026-07-28T14:38:14.771Z # Harmonized with ECC run: 2026-07-28T01:26:19.263Z (PR #16 on merged) # Additive replay from ECC run: 2026-07-28T14:39:08.509Z (PR #18) +# Workflow-pack additive replay: 2026-07-29T00:00:00.000Z (PR #21 — commands only; instincts unchanged) # Version: 2.0 # Absorbed ID aliases from the second run: # - periscope-instinct-commit-format -> periscope-instinct-git-commit-format diff --git a/.claude/skills/periscope/SKILL.md b/.claude/skills/periscope/SKILL.md index 83661ceb0..ffca8e6cb 100644 --- a/.claude/skills/periscope/SKILL.md +++ b/.claude/skills/periscope/SKILL.md @@ -232,3 +232,6 @@ and handoff notes before expanding scope. | `/database-migration` | `.claude/commands/database-migration.md` | | `/feature-development` | `.claude/commands/feature-development.md` | | `/refactoring` | `.claude/commands/refactoring.md` | +| `/add-or-update-backend-feature-with-tests` | `.claude/commands/add-or-update-backend-feature-with-tests.md` | +| `/frontend-component-update-with-i18n-and-tests` | `.claude/commands/frontend-component-update-with-i18n-and-tests.md` | +| `/documentation-and-blueprint-update` | `.claude/commands/documentation-and-blueprint-update.md` |