feat: add periscope ECC bundle

.agents/skills/periscope/SKILL.md

@@ -0,0 +1,96 @@
+```markdown
+# periscope Development Patterns
+
+> Auto-generated skill from repository analysis
+
+## Overview
+This skill teaches the core development patterns and conventions used in the `periscope` Go repository. You'll learn about file naming, import/export styles, commit message conventions, and how to structure and run tests. This guide is ideal for contributors looking to maintain consistency and quality in the codebase.
+
+## Coding Conventions
+
+### File Naming
+- Use **snake_case** for all file names.
+  - Example:  
+    ```
+    data_processor.go
+    user_service.go
+    ```
+
+### Import Style
+- Use **relative imports** within the module.
+  - Example:
+    ```go
+    import (
+        "fmt"
+        "../utils"
+    )
+    ```
+
+### Export Style
+- Use **named exports** for functions, types, and variables.
+  - Example:
+    ```go
+    // Exported function
+    func ProcessData(input string) error {
+        // ...
+    }
+    ```
+
+### Commit Messages
+- Follow **conventional commit** style.
+- Use the `fix` prefix for bug fixes.
+- Keep commit messages concise (average 61 characters).
+  - Example:
+    ```
+    fix: handle nil pointer in data_processor.go
+    ```
+
+## Workflows
+
+### Bug Fix Workflow
+**Trigger:** When fixing a bug in the codebase  
+**Command:** `/fix-bug`
+
+1. Identify and reproduce the bug.
+2. Create a new branch for the fix.
+3. Apply the fix, following coding conventions.
+4. Write or update relevant tests.
+5. Commit changes using the `fix:` prefix.
+6. Push the branch and open a pull request.
+
+### Add Feature Workflow
+**Trigger:** When adding a new feature  
+**Command:** `/add-feature`
+
+1. Create a new branch for the feature.
+2. Implement the feature using snake_case file naming and relative imports.
+3. Export new functions/types with named exports.
+4. Write corresponding tests in `*.test.*` files.
+5. Commit with a descriptive message (use a relevant conventional prefix).
+6. Push the branch and open a pull request.
+
+## Testing Patterns
+
+- Test files follow the pattern: `*.test.*`
+  - Example: `data_processor.test.go`
+- Testing framework is not explicitly defined; use Go's standard testing tools unless otherwise specified.
+- Place tests alongside the code they test, using the same naming conventions.
+
+  Example test file:
+  ```go
+  // data_processor.test.go
+  package periscope
+
+  import "testing"
+
+  func TestProcessData(t *testing.T) {
+      // test logic here
+  }
+  ```
+
+## Commands
+| Command      | Purpose                                 |
+|--------------|-----------------------------------------|
+| /fix-bug     | Start the bug fix workflow              |
+| /add-feature | Start the add feature workflow          |
+```

.agents/skills/periscope/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Periscope"
+  short_description: "Repo-specific patterns and workflows for periscope"
+  default_prompt: "Use the periscope repo skill to follow existing architecture, testing, and workflow conventions."
+policy:
+  allow_implicit_invocation: true

.claude/ecc-tools.json

@@ -0,0 +1,227 @@
+{
+  "version": "1.3",
+  "schemaVersion": "1.0",
+  "generatedBy": "ecc-tools",
+  "generatedAt": "2026-07-29T03:00:08.910Z",
+  "repo": "https://github.com/diazMelgarejo/periscope",
+  "referenceSetReadiness": {
+    "score": 0,
+    "present": 0,
+    "total": 7,
+    "items": [
+      {
+        "id": "deep-analyzer-corpus",
+        "label": "Deep analyzer corpus",
+        "status": "missing",
+        "evidence": [],
+        "recommendation": "Add analyzer fixture, golden, benchmark, or reference-set files that can catch analyzer regressions."
+      },
+      {
+        "id": "rag-evaluator",
+        "label": "RAG/evaluator comparison",
+        "status": "missing",
+        "evidence": [],
+        "recommendation": "Add retrieval or evaluator reference-set comparison fixtures with expected ranking behavior."
+      },
+      {
+        "id": "pr-salvage",
+        "label": "PR salvage/review corpus",
+        "status": "missing",
+        "evidence": [],
+        "recommendation": "Add stale-PR, review-thread, reopen-flow, or salvage reference cases for queue cleanup automation."
+      },
+      {
+        "id": "discussion-triage",
+        "label": "Discussion triage corpus",
+        "status": "missing",
+        "evidence": [],
+        "recommendation": "Add public discussion triage fixtures, golden cases, or reference sets for informational, answered, and no-response classifications."
+      },
+      {
+        "id": "harness-compatibility",
+        "label": "Harness compatibility",
+        "status": "missing",
+        "evidence": [],
+        "recommendation": "Add cross-harness, adapter-compliance, or harness-audit evidence for Claude, Codex, OpenCode, Zed, dmux, and agent surfaces."
+      },
+      {
+        "id": "security-evidence",
+        "label": "Security evidence",
+        "status": "missing",
+        "evidence": [],
+        "recommendation": "Attach security evidence such as SBOMs, SARIF, audit reports, or AgentShield evidence packs."
+      },
+      {
+        "id": "ci-failure-mode",
+        "label": "CI failure-mode evidence",
+        "status": "missing",
+        "evidence": [],
+        "recommendation": "Add captured CI failure logs, dry-run fixtures, or troubleshooting docs for common workflow failure modes."
+      }
+    ]
+  },
+  "profiles": {
+    "requested": "core",
+    "recommended": "core",
+    "effective": "core",
+    "requestedAlias": "core",
+    "recommendedAlias": "core",
+    "effectiveAlias": "core"
+  },
+  "requestedProfile": "core",
+  "profile": "core",
+  "recommendedProfile": "core",
+  "effectiveProfile": "core",
+  "tier": "free",
+  "requestedComponents": [
+    "repo-baseline"
+  ],
+  "selectedComponents": [
+    "repo-baseline"
+  ],
+  "requestedAddComponents": [],
+  "requestedRemoveComponents": [],
+  "blockedRemovalComponents": [],
+  "tierFilteredComponents": [],
+  "requestedRootPackages": [
+    "runtime-core"
+  ],
+  "selectedRootPackages": [
+    "runtime-core"
+  ],
+  "requestedPackages": [
+    "runtime-core"
+  ],
+  "requestedAddPackages": [],
+  "requestedRemovePackages": [],
+  "selectedPackages": [
+    "runtime-core"
+  ],
+  "packages": [
+    "runtime-core"
+  ],
+  "blockedRemovalPackages": [],
+  "tierFilteredRootPackages": [],
+  "tierFilteredPackages": [],
+  "conflictingPackages": [],
+  "dependencyGraph": {
+    "runtime-core": []
+  },
+  "resolutionOrder": [
+    "runtime-core"
+  ],
+  "requestedModules": [
+    "runtime-core"
+  ],
+  "selectedModules": [
+    "runtime-core"
+  ],
+  "modules": [
+    "runtime-core"
+  ],
+  "managedFiles": [
+    ".claude/skills/periscope/SKILL.md",
+    ".agents/skills/periscope/SKILL.md",
+    ".agents/skills/periscope/agents/openai.yaml",
+    ".claude/identity.json",
+    ".codex/config.toml",
+    ".codex/AGENTS.md",
+    ".codex/agents/explorer.toml",
+    ".codex/agents/reviewer.toml",
+    ".codex/agents/docs-researcher.toml",
+    ".claude/homunculus/instincts/inherited/periscope-instincts.yaml"
+  ],
+  "packageFiles": {
+    "runtime-core": [
+      ".claude/skills/periscope/SKILL.md",
+      ".agents/skills/periscope/SKILL.md",
+      ".agents/skills/periscope/agents/openai.yaml",
+      ".claude/identity.json",
+      ".codex/config.toml",
+      ".codex/AGENTS.md",
+      ".codex/agents/explorer.toml",
+      ".codex/agents/reviewer.toml",
+      ".codex/agents/docs-researcher.toml",
+      ".claude/homunculus/instincts/inherited/periscope-instincts.yaml"
+    ]
+  },
+  "moduleFiles": {
+    "runtime-core": [
+      ".claude/skills/periscope/SKILL.md",
+      ".agents/skills/periscope/SKILL.md",
+      ".agents/skills/periscope/agents/openai.yaml",
+      ".claude/identity.json",
+      ".codex/config.toml",
+      ".codex/AGENTS.md",
+      ".codex/agents/explorer.toml",
+      ".codex/agents/reviewer.toml",
+      ".codex/agents/docs-researcher.toml",
+      ".claude/homunculus/instincts/inherited/periscope-instincts.yaml"
+    ]
+  },
+  "files": [
+    {
+      "moduleId": "runtime-core",
+      "path": ".claude/skills/periscope/SKILL.md",
+      "description": "Repository-specific Claude Code skill generated from git history."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".agents/skills/periscope/SKILL.md",
+      "description": "Codex-facing copy of the generated repository skill."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".agents/skills/periscope/agents/openai.yaml",
+      "description": "Codex skill metadata so the repo skill appears cleanly in the skill interface."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".claude/identity.json",
+      "description": "Suggested identity.json baseline derived from repository conventions."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".codex/config.toml",
+      "description": "Repo-local Codex MCP and multi-agent baseline aligned with ECC defaults."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".codex/AGENTS.md",
+      "description": "Codex usage guide that points at the generated repo skill and workflow bundle."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".codex/agents/explorer.toml",
+      "description": "Read-only explorer role config for Codex multi-agent work."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".codex/agents/reviewer.toml",
+      "description": "Read-only reviewer role config focused on correctness and security."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".codex/agents/docs-researcher.toml",
+      "description": "Read-only docs researcher role config for API verification."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".claude/homunculus/instincts/inherited/periscope-instincts.yaml",
+      "description": "Continuous-learning instincts derived from repository patterns."
+    }
+  ],
+  "workflows": [],
+  "adapters": {
+    "claudeCode": {
+      "skillPath": ".claude/skills/periscope/SKILL.md",
+      "identityPath": ".claude/identity.json",
+      "commandPaths": []
+    },
+    "codex": {
+      "configPath": ".codex/config.toml",
+      "agentsGuidePath": ".codex/AGENTS.md",
+      "skillPath": ".agents/skills/periscope/SKILL.md"
+    }
+  }
+}