Skip to content

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

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

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 repo-local ECC bundle to standardize Claude Code and Codex workflows for refined-github-projects. Previously no ECC artifacts existed; now the repo provides skills, a Codex baseline, multi‑agent roles, and a refactoring command to align tooling with project conventions.

  • Review and rollout
    • Verify the generated conventions (TypeScript/React, vitest, path aliases, conventional commits) in .claude/skills/... and .agents/skills/... match the repo; adjust as needed.
    • Codex baseline .codex/config.toml enables MCP servers @modelcontextprotocol/server-github, @upstash/context7-mcp, @modelcontextprotocol/server-memory, @playwright/mcp, and @modelcontextprotocol/server-sequential-thinking; approval policy is on-request, sandbox is workspace-write, and multi-agent is enabled.
    • Required: add any credentials or user-specific MCP config to ~/.codex/config.toml; do not commit secrets.
    • Optional: import continuous-learning instincts with /instinct-import .claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml.
    • No runtime or build behavior changes; these files only affect developer tooling and agent behavior.

Written for commit c73cd7d. 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 this generated ECC config-only bundle; Cursor Bugbot was not present after the first poll, so that signal was skipped. No reviewers assigned.

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Approver

@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.

Generated ECC guidance has several high-confidence factual errors (monorepo, ~/ aliases, fictional import paths, wrong type folders) that would steer agents into incorrect layout and imports. Committed Codex MCP defaults also pin @latest and enable a remote third-party server.

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


## 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 is a single-package WXT browser extension, not a monorepo—pnpm-workspace.yaml has no packages: entries and there is no packages/ tree. Correct this (and the identical .agents/skills/.../SKILL.md copy) so agents do not invent a multi-package layout.


### 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.

components/, services/, and utils/ do not exist here. Point agents at the real type folders already listed in Source Layout (features/, lib/, ui/, background/, entries/, assets/). Mirror the fix in the .agents skill copy.

| 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 @src is configured (vitest.config.ts); the repo has zero ~/ imports. Drop ~/ from this guidance (and the .agents copy) or agents will emit broken import paths.


```typescript
// Use path aliases for imports
import { Button } from '@/components/Button'

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

These examples reference modules that do not exist (@/components/Button, @/hooks/useAuth, @/lib/api). Replace with real paths such as @/ui/..., @/lib/..., @/features/... so agents follow the actual codebase.


## 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.

Action instructs agents to place code in components/, services/, utils/, which are not present. Align the Action with the Evidence folders (assets, background, entries, features, lib, and ui) before this instinct is imported.

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.

Repo-local Codex defaults should not use unpinned @latest MCP packages (also on Playwright below) or silently enable the remote Exa MCP at https://mcp.exa.ai/mcp. Pin versions and keep third-party/remote MCPs opt-in via ~/.codex/config.toml to avoid supply-chain and data-exfiltration risk for anyone loading this repo config.

@fathiraz fathiraz closed this Aug 15, 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