Merge pull request #30 from diazMelgarejo/ecc-tools/periscope-1785310602022

Author: diazMelgarejo

.claude/commands/context-visualizer-ui-feature-workflow.md

@@ -0,0 +1,42 @@
+---
+name: context-visualizer-ui-feature-workflow
+description: Workflow command scaffold for context-visualizer-ui-feature-workflow in periscope.
+allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
+---
+
+# /context-visualizer-ui-feature-workflow
+
+Use this workflow when working on **context-visualizer-ui-feature-workflow** in `periscope`.
+
+## Goal
+
+Implements or migrates context visualizer UI features, including bug fixes, refactors, and kit-ui migrations.
+
+## Common Files
+
+- `frontend/src/lib/components/context/*.svelte`
+- `frontend/src/lib/components/context/*.test.ts`
+- `frontend/messages/*.json`
+- `frontend/scripts/generate-api-client.mjs`
+- `docs/context-session-visualizer-mvp-plan.md`
+- `docs/context-session-visualizer-roadmap.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 Svelte components under frontend/src/lib/components/context/
+- Update or add related test files (*.test.ts) for those components
+- Update frontend/messages/*.json for i18n if needed
+- Update or fix docs/context-session-visualizer-*.md and docs/context-visualizer-ui-recommendation.md as needed
+- Update frontend/scripts/generate-api-client.mjs if API changes
+
+## Notes
+
+- Treat this as a scaffold, not a hard-coded script.
+- Update the command if the workflow evolves materially.

.claude/commands/database-migration.md

@@ -15,6 +15,7 @@ Database schema changes with migration files
 ## Common Files
 
 - `**/schema.*`
+- `migrations/*`
 
 ## Suggested Sequence
 

.claude/commands/database-schema-and-storage-migration.md

@@ -0,0 +1,42 @@
+---
+name: database-schema-and-storage-migration
+description: Workflow command scaffold for database-schema-and-storage-migration in periscope.
+allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
+---
+
+# /database-schema-and-storage-migration
+
+Use this workflow when working on **database-schema-and-storage-migration** in `periscope`.
+
+## Goal
+
+Adds or modifies database tables, triggers, or storage logic, including migrations and related Go code/tests.
+
+## Common Files
+
+- `internal/db/schema.sql`
+- `internal/db/*.go`
+- `internal/db/*_test.go`
+- `internal/artifact/*.go`
+- `internal/artifact/*_test.go`
+- `internal/parser/*.go`
+
+## 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 internal/db/schema.sql or equivalent Go migration logic
+- Update or add Go files in internal/db/ (e.g., artifact_publication.go, sessions.go, usage_events.go)
+- Update or add related test files in internal/db/
+- Edit or add storage logic in internal/artifact/ or internal/parser/ as needed
+- Update docs/specs or plans if schema or storage design changes
+
+## Notes
+
+- Treat this as a scaffold, not a hard-coded script.
+- Update the command if the workflow evolves materially.

.claude/ecc-tools.json

@@ -55,8 +55,7 @@
         "label": "Security evidence",
         "status": "present",
         "evidence": [
-          "scripts/git/audit_attribution.sh",
-          "scripts/git/audit_engine.py"
+          "SECURITY.md"
         ],
         "recommendation": "Attach security evidence such as SBOMs, SARIF, audit reports, or AgentShield evidence packs."
       },
@@ -339,6 +338,16 @@
       "moduleId": "workflow-pack",
       "path": ".claude/commands/feature-development-with-tests-and-docs.md",
       "description": "Workflow command scaffold for feature-development-with-tests-and-docs."
+    },
+    {
+      "moduleId": "workflow-pack",
+      "path": ".claude/commands/context-visualizer-ui-feature-workflow.md",
+      "description": "Workflow command scaffold for context-visualizer-ui-feature-workflow."
+    },
+    {
+      "moduleId": "workflow-pack",
+      "path": ".claude/commands/database-schema-and-storage-migration.md",
+      "description": "Workflow command scaffold for database-schema-and-storage-migration."
     }
   ],
   "workflows": [
@@ -365,6 +374,18 @@
     {
       "command": "feature-development-with-tests-and-docs",
       "path": ".claude/commands/feature-development-with-tests-and-docs.md"
+    },
+    {
+      "command": "context-visualizer-ui-feature-workflow",
+      "path": ".claude/commands/context-visualizer-ui-feature-workflow.md"
+    },
+    {
+      "command": "database-schema-and-storage-migration",
+      "path": ".claude/commands/database-schema-and-storage-migration.md"
+    },
+    {
+      "command": "database-migration",
+      "path": ".claude/commands/database-migration.md"
     }
   ],
   "adapters": {

.codex/AGENTS.md

@@ -31,6 +31,8 @@ The generated baseline enables GitHub, Context7, Exa, Memory, Playwright, and Se
 - `.claude/commands/add-new-parser-or-provider.md`
 - `.claude/commands/feature-development-with-tests-and-docs.md`
 
+- `.claude/commands/context-visualizer-ui-feature-workflow.md`
+- `.claude/commands/database-schema-and-storage-migration.md`
 Use these workflow files as reusable task scaffolds when the detected repository workflows recur.
 Pair them with the synthesized instincts in
 `.claude/homunculus/instincts/inherited/periscope-instincts.yaml` and the workflow