Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .agents/skills/periscope/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` |
41 changes: 41 additions & 0 deletions .claude/commands/add-or-update-backend-feature-with-tests.md
Original file line number Diff line number Diff line change
@@ -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.
37 changes: 37 additions & 0 deletions .claude/commands/documentation-and-blueprint-update.md
Original file line number Diff line number Diff line change
@@ -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.
38 changes: 38 additions & 0 deletions .claude/commands/frontend-component-update-with-i18n-and-tests.md
Original file line number Diff line number Diff line change
@@ -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.
67 changes: 48 additions & 19 deletions .claude/ecc-tools.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": [
{
Expand All @@ -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."
},
{
Expand All @@ -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."
},
Expand All @@ -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."
},
Expand Down Expand Up @@ -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": [
Expand All @@ -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": {
Expand All @@ -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": [
Expand Down Expand Up @@ -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": {
Expand All @@ -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": {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 3 additions & 0 deletions .claude/skills/periscope/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` |