Skip to content

feat: add refined-github-projects ECC bundle - #63

Closed
ecc-tools[bot] wants to merge 12 commits into
mainfrom
ecc-tools/refined-github-projects-1781444461944
Closed

feat: add refined-github-projects ECC bundle#63
ecc-tools[bot] wants to merge 12 commits into
mainfrom
ecc-tools/refined-github-projects-1781444461944

Conversation

@ecc-tools

@ecc-tools ecc-tools Bot commented Aug 15, 2026

Copy link
Copy Markdown

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/refined-github-projects/SKILL.md Repository-specific Claude Code skill generated from git history.
.agents/skills/refined-github-projects/SKILL.md Codex-facing copy of the generated repository skill.
.agents/skills/refined-github-projects/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/refined-github-projects-instincts.yaml Continuous-learning instincts derived from repository patterns.
.claude/commands/refactoring.md Workflow command scaffold for refactoring.
Optional: Continuous Learning (12 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/refined-github-projects-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 cubic

Adds a repository-local ECC bundle to standardize Claude Code and Codex workflows for this repo. Previously we had no ECC artifacts; now we ship a repo skill, a multi-agent Codex baseline, and a /refactoring workflow without changing application code.

  • Scope: adds .claude/, .agents/, and .codex/ configs only; no src/ changes.
  • Codex baseline: approval_policy=on-request, sandbox_mode=workspace-write, multi_agent=true with Explorer, Reviewer, and Docs Researcher; MCP servers include @modelcontextprotocol/server-github, @upstash/context7-mcp, @modelcontextprotocol/server-memory, @playwright/mcp, @modelcontextprotocol/server-sequential-thinking, and exa.
  • Repo skill: documents commit/test/architecture conventions for this project; allow_implicit_invocation: true in openai.yaml.
  • Workflow: adds /refactoring scaffold at .claude/commands/refactoring.md.
  • Optional: to enable continuous-learning instincts, import .claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml via /instinct-import ....

Written for commit c2a717f. Summary will update on new commits.

Review in cubic

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk: medium. Approved; Cursor Bugbot was not present after the initial check poll, and these additive agent-config files stay within the medium-risk threshold. No reviewers were assigned.

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Approver

Comment thread .codex/config.toml

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp@latest"]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔒 Agentic Security Review
Severity: HIGH
The new MCP server setup executes packages via npx -y with floating versions (including @latest), which performs runtime download-and-execute of remote npm code without immutable version pinning.
Impact: A compromised upstream package release can execute arbitrary code in the maintainer environment and access local source and credentials available to the Codex process.

Fix in Cursor Fix in Web

Reviewed by Cursor Security Reviewer for commit c2a717f. Configure here.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor auto review

Found 6 actionable issue(s) on changed lines.

The generated repo skill and instincts encode false project conventions that agents will follow. This is a single-package WXT browser extension, not a React monorepo; only the @/ alias exists; and source lives in features/ui/lib/background/entries, not components/services/utils. Fix both SKILL.md copies plus the matching instincts before merge.

Generated automatically when this PR was submitted using Cursor CLI with --model auto.

- **Architecture**: type-based module organization
- **Test Location**: colocated
- **Test Framework**: vitest

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a WXT browser extension (content/background/popup entrypoints, GitHub GraphQL from the page), not a generic React app. Update the tech stack here and in .agents/skills/refined-github-projects/SKILL.md so agents don't scaffold a web app.


## Architecture

### Project Structure: Monorepo

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This repo is a single package, not a monorepo (pnpm-workspace.yaml has no packages: workspaces). Relabel it as a single-package WXT extension and apply the same fix to the Codex skill copy.


### Guidelines

- Group code by type (components, services, utils)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The repo does not use components/, services/, or utils/. New code goes in src/features/, src/ui/, src/lib/, src/background/, or src/entries/. These guidelines (and the matching instinct) will create the wrong tree.

| Classes | PascalCase |
| Constants | SCREAMING_SNAKE_CASE |

### Import Style: Path Aliases (@/, ~/)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only @/ is configured (@src/ in vitest.config.ts); ~/ is unused. The examples below (@/components/Button, @/hooks/useAuth) do not exist — use @/lib/..., @/ui/..., @/features/....


## Action

Use path aliases (@/, ~/) instead of relative imports

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This instinct will fire on every import with a false ~/ alias. Restrict it to @/ (maps to src/); there are no ~/ imports in this repo.


## Action

Place code in the appropriate type folder (components/, services/, utils/, etc.)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are no components/, services/, or utils/ folders. Instruct agents to place code in src/features, src/ui, src/lib, src/background, or src/entries instead.

@fathiraz fathiraz closed this Aug 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant