feat: add cognitive-os ECC bundle

[ecc-tools]

Summary

Auto-generated ECC bundle from repository analysis.

What This Does

Merging this PR adds repo-local ECC artifacts for both Claude Code and Codex. The generated bundle captures repository patterns, Codex baseline config, and reusable workflow scaffolds derived from git history analysis.

Analysis Scope

• Commit history patterns and conventions
• Code architecture and structure
• Testing patterns and coverage
• Recurring workflows

Files

Path	Description
.claude/ecc-tools.json	ECC install manifest used for upgrades, repair, and uninstall.
.claude/skills/cognitive-os/SKILL.md	Repository-specific Claude Code skill generated from git history.
.agents/skills/cognitive-os/SKILL.md	Codex-facing copy of the generated repository skill.
.agents/skills/cognitive-os/agents/openai.yaml	Codex skill metadata so the repo skill appears cleanly in the skill interface.
.claude/identity.json	Suggested identity.json baseline derived from repository conventions.
.codex/config.toml	Repo-local Codex MCP and multi-agent baseline aligned with ECC defaults.
.codex/AGENTS.md	Codex usage guide that points at the generated repo skill and workflow bundle.
.codex/agents/explorer.toml	Read-only explorer role config for Codex multi-agent work.
.codex/agents/reviewer.toml	Read-only reviewer role config focused on correctness and security.
.codex/agents/docs-researcher.toml	Read-only docs researcher role config for API verification.
.claude/homunculus/instincts/inherited/cognitive-os-instincts.yaml	Continuous-learning instincts derived from repository patterns.

Optional: Continuous Learning (6 instincts)

This PR also includes instincts for the continuous-learning-v2 skill. These are optional and only useful if you use that skill.

Import after merging:

/instinct-import .claude/homunculus/instincts/inherited/cognitive-os-instincts.yaml

Review Checklist

• Verify detected patterns are accurate
• Confirm generated config, commands, and skill metadata match the repo’s real workflow
• Check best practices align with team standards before merging

---

_{ECC Tools | Everything Claude Code}

Summary by Sourcery

Add generated ECC configuration, skills, and workflow guidance for Claude Code and Codex use in the repository.

New Features:

• Add repository-local Claude Code and Codex skills capturing project conventions and workflows.
• Add a Codex baseline with MCP integrations and read-only multi-agent roles for exploration, review, and documentation research.

Enhancements:

• Add generated continuous-learning instincts covering commit, naming, import, export, and test-location conventions.
• Add repository identity and ECC installation metadata for managing the generated tooling bundle.

[sourcery-ai]

Reviewer's Guide

This PR adds an ECC-generated, repo-local configuration bundle for Claude Code and Codex, including mirrored development skills, optional learning instincts, MCP and multi-agent defaults, and supporting installation and identity metadata.

Sequence diagram for repository-aware agent workflows

sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant Codex as Codex CLI
    participant Skill as cognitive-os skill
    participant MCP as MCP services
    participant Agents as Read-only agents

    User->>Claude: Work on repository
    Claude->>Skill: Load repository conventions
    Skill-->>Claude: Return architecture, testing, and commit guidance
    User->>Codex: Run repository task
    Codex->>Skill: Load mirrored repository skill
    Codex->>MCP: Use configured GitHub, docs, search, or browser tools
    Codex->>Agents: Delegate exploration, review, or docs verification
    Agents-->>Codex: Return evidence and findings
    Codex-->>User: Provide task result

Loading

File-Level Changes

Change	Details	Files
Add mirrored repository-specific cognitive-os skills for Claude Code and Codex.	Document detected technology, architecture, naming, import/export, testing, and commit conventions. Expose Codex skill metadata with implicit invocation enabled.	.claude/skills/cognitive-os/SKILL.md .agents/skills/cognitive-os/SKILL.md .agents/skills/cognitive-os/agents/openai.yaml
Add ECC installation, identity, and optional continuous-learning artifacts.	Provide the ECC install manifest and generated identity baseline. Add six inherited instincts covering commits, naming, imports, exports, and test placement.	.claude/ecc-tools.json .claude/identity.json .claude/homunculus/instincts/inherited/cognitive-os-instincts.yaml
Configure repo-local Codex defaults and read-only multi-agent roles.	Enable workspace-write execution, live web search, MCP integrations, and multi-agent support. Define explorer, reviewer, and documentation-researcher agents with role-specific instructions and sandbox settings. Document repo skill locations, credential boundaries, MCP baseline, and workflow usage.	.codex/config.toml .codex/AGENTS.md .codex/agents/explorer.toml .codex/agents/reviewer.toml .codex/agents/docs-researcher.toml

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

Hey - I've found 1 issue

Prompt for AI Agents

Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path=".codex/AGENTS.md" line_range="3" />
<code_context>
+# ECC for Codex CLI
+
+This supplements the root `AGENTS.md` with a repo-local ECC baseline.
+
+## Repo Skill
</code_context>
<issue_to_address>
**issue (bug_risk):** When Codex is launched from the repository root, it does not discover `.codex/AGENTS.md` as an instruction file because that file is in a child directory rather than the current directory or one of its parents. The repo-local skill, MCP guidance, and multi-agent instructions in this file therefore are not applied to ordinary repository work.

**Triggers:** When Codex is invoked from the repository root or another directory outside `.codex`.

**Suggested fix:** Put the repo-wide Codex instructions in the root `CODEX.md`/`AGENTS.md`, or explicitly configure Codex to load `.codex/AGENTS.md` if that is supported by the target CLI.
</issue_to_address>

Sourcery assessment

Approval pending. 1 finding to address first.

Blocking findings: .codex/AGENTS.md:3

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[sourcery-ai]

issue (bug_risk): When Codex is launched from the repository root, it does not discover .codex/AGENTS.md as an instruction file because that file is in a child directory rather than the current directory or one of its parents. The repo-local skill, MCP guidance, and multi-agent instructions in this file therefore are not applied to ordinary repository work.

Triggers: When Codex is invoked from the repository root or another directory outside .codex.

Suggested fix: Put the repo-wide Codex instructions in the root CODEX.md/AGENTS.md, or explicitly configure Codex to load .codex/AGENTS.md if that is supported by the target CLI.