diazMelgarejo · diazMelgarejo · Jul 28, 2026 · Jul 28, 2026
diff --git a/.agents/skills/periscope/SKILL.md b/.agents/skills/periscope/SKILL.md
@@ -0,0 +1,74 @@
+```markdown
+# periscope Development Patterns
+
+> Auto-generated skill from repository analysis
+
+## Overview
+This skill teaches you the core development patterns and conventions used in the `periscope` TypeScript codebase. You'll learn how to name files, structure imports/exports, write commits, and organize tests. This guide also provides suggested commands for common workflows, ensuring consistency and efficiency in your contributions.
+
+## Coding Conventions
+
+### File Naming
+- Use **kebab-case** for all file names.
+  - Example:  
+    ```
+    user-profile.ts
+    data-fetcher.test.ts
+    ```
+
+### Import Style
+- Use **relative imports** for module references.
+  - Example:
+    ```typescript
+    import { fetchData } from './data-fetcher';
+    ```
+
+### Export Style
+- Use **named exports** only.
+  - Example:
+    ```typescript
+    // In user-profile.ts
+    export function getUserProfile(id: string) { ... }
+    ```
+
+### Commit Messages
+- Follow **conventional commit** format.
+- Use the `chore` prefix for all commits.
+- Keep commit messages concise (average ~59 characters).
+  - Example:
+    ```
+    chore: update dependencies to latest versions
+    ```
+
+## Workflows
+
+### Code Contribution
+**Trigger:** When adding or updating code  
+**Command:** `/contribute`
+
+1. Create or update files using kebab-case naming.
+2. Use relative imports and named exports.
+3. Write clear, conventional commit messages with the `chore` prefix.
+4. If applicable, add or update corresponding test files (`*.test.ts`).
+
+### Testing
+**Trigger:** When verifying code correctness  
+**Command:** `/test`
+
+1. Locate or create a test file matching `*.test.*` pattern.
+2. Write or update test cases as needed.
+3. Run your test suite using the project's test runner (framework unknown; check project scripts or documentation).
+4. Ensure all tests pass before committing.
+
+## Testing Patterns
+
+- Test files follow the `*.test.*` naming convention (e.g., `user-profile.test.ts`).
+- The specific testing framework is not detected; check existing test files for structure or consult project documentation.
+- Place tests close to the code they verify for clarity and maintainability.
+
+## Commands
+| Command      | Purpose                                    |
+|--------------|--------------------------------------------|
+| /contribute  | Guide for contributing code changes        |
+| /test        | Steps for writing and running tests        |
+```
diff --git a/.agents/skills/periscope/agents/openai.yaml b/.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
diff --git a/.claude/ecc-tools.json b/.claude/ecc-tools.json
@@ -0,0 +1,229 @@
+{
+  "version": "1.3",
+  "schemaVersion": "1.0",
+  "generatedBy": "ecc-tools",
+  "generatedAt": "2026-07-28T00:55:21.186Z",
+  "repo": "https://github.com/diazMelgarejo/periscope",
+  "referenceSetReadiness": {
+    "score": 14,
+    "present": 1,
+    "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": "present",
+        "evidence": [
+          "scripts/git/audit_attribution.sh"
+        ],
+        "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"
+    }
+  }
+}