feat: harmonize ECC workflow-pack onto current merged (PR #21 synthesis) (#21)

Author: ecc-tools[bot]

.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` |

.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.

.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.

.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.

.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": {

.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

.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` |