From 2304846f744cfbb5884dd5a0ff52bc51a0aecf67 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:37 +0000 Subject: [PATCH 01/14] feat: add react-ui-library ECC bundle (.claude/ecc-tools.json) --- .claude/ecc-tools.json | 286 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 286 insertions(+) create mode 100644 .claude/ecc-tools.json diff --git a/.claude/ecc-tools.json b/.claude/ecc-tools.json new file mode 100644 index 0000000..006d382 --- /dev/null +++ b/.claude/ecc-tools.json @@ -0,0 +1,286 @@ +{ + "version": "1.3", + "schemaVersion": "1.0", + "generatedBy": "ecc-tools", + "generatedAt": "2026-06-30T10:54:00.342Z", + "repo": "https://github.com/wyf027/react-ui-library", + "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": "developer", + "recommended": "developer", + "effective": "developer", + "requestedAlias": "developer", + "recommendedAlias": "developer", + "effectiveAlias": "developer" + }, + "requestedProfile": "developer", + "profile": "developer", + "recommendedProfile": "developer", + "effectiveProfile": "developer", + "tier": "free", + "requestedComponents": [ + "repo-baseline", + "workflow-automation" + ], + "selectedComponents": [ + "repo-baseline", + "workflow-automation" + ], + "requestedAddComponents": [], + "requestedRemoveComponents": [], + "blockedRemovalComponents": [], + "tierFilteredComponents": [], + "requestedRootPackages": [ + "runtime-core", + "workflow-pack" + ], + "selectedRootPackages": [ + "runtime-core", + "workflow-pack" + ], + "requestedPackages": [ + "runtime-core", + "workflow-pack" + ], + "requestedAddPackages": [], + "requestedRemovePackages": [], + "selectedPackages": [ + "runtime-core", + "workflow-pack" + ], + "packages": [ + "runtime-core", + "workflow-pack" + ], + "blockedRemovalPackages": [], + "tierFilteredRootPackages": [], + "tierFilteredPackages": [], + "conflictingPackages": [], + "dependencyGraph": { + "runtime-core": [], + "workflow-pack": [ + "runtime-core" + ] + }, + "resolutionOrder": [ + "runtime-core", + "workflow-pack" + ], + "requestedModules": [ + "runtime-core", + "workflow-pack" + ], + "selectedModules": [ + "runtime-core", + "workflow-pack" + ], + "modules": [ + "runtime-core", + "workflow-pack" + ], + "managedFiles": [ + ".claude/skills/react-ui-library/SKILL.md", + ".agents/skills/react-ui-library/SKILL.md", + ".agents/skills/react-ui-library/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/react-ui-library-instincts.yaml", + ".claude/commands/feature-development.md", + ".claude/commands/add-or-update-component-documentation.md", + ".claude/commands/add-new-ui-component.md" + ], + "packageFiles": { + "runtime-core": [ + ".claude/skills/react-ui-library/SKILL.md", + ".agents/skills/react-ui-library/SKILL.md", + ".agents/skills/react-ui-library/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/react-ui-library-instincts.yaml" + ], + "workflow-pack": [ + ".claude/commands/feature-development.md", + ".claude/commands/add-or-update-component-documentation.md", + ".claude/commands/add-new-ui-component.md" + ] + }, + "moduleFiles": { + "runtime-core": [ + ".claude/skills/react-ui-library/SKILL.md", + ".agents/skills/react-ui-library/SKILL.md", + ".agents/skills/react-ui-library/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/react-ui-library-instincts.yaml" + ], + "workflow-pack": [ + ".claude/commands/feature-development.md", + ".claude/commands/add-or-update-component-documentation.md", + ".claude/commands/add-new-ui-component.md" + ] + }, + "files": [ + { + "moduleId": "runtime-core", + "path": ".claude/skills/react-ui-library/SKILL.md", + "description": "Repository-specific Claude Code skill generated from git history." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/react-ui-library/SKILL.md", + "description": "Codex-facing copy of the generated repository skill." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/react-ui-library/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/react-ui-library-instincts.yaml", + "description": "Continuous-learning instincts derived from repository patterns." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/feature-development.md", + "description": "Workflow command scaffold for feature-development." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/add-or-update-component-documentation.md", + "description": "Workflow command scaffold for add-or-update-component-documentation." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/add-new-ui-component.md", + "description": "Workflow command scaffold for add-new-ui-component." + } + ], + "workflows": [ + { + "command": "feature-development", + "path": ".claude/commands/feature-development.md" + }, + { + "command": "add-or-update-component-documentation", + "path": ".claude/commands/add-or-update-component-documentation.md" + }, + { + "command": "add-new-ui-component", + "path": ".claude/commands/add-new-ui-component.md" + } + ], + "adapters": { + "claudeCode": { + "skillPath": ".claude/skills/react-ui-library/SKILL.md", + "identityPath": ".claude/identity.json", + "commandPaths": [ + ".claude/commands/feature-development.md", + ".claude/commands/add-or-update-component-documentation.md", + ".claude/commands/add-new-ui-component.md" + ] + }, + "codex": { + "configPath": ".codex/config.toml", + "agentsGuidePath": ".codex/AGENTS.md", + "skillPath": ".agents/skills/react-ui-library/SKILL.md" + } + } +} \ No newline at end of file From 6c50a585e7ad4e3d2b14011310da77263326abe7 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:38 +0000 Subject: [PATCH 02/14] feat: add react-ui-library ECC bundle (.claude/skills/react-ui-library/SKILL.md) --- .claude/skills/react-ui-library/SKILL.md | 174 +++++++++++++++++++++++ 1 file changed, 174 insertions(+) create mode 100644 .claude/skills/react-ui-library/SKILL.md diff --git a/.claude/skills/react-ui-library/SKILL.md b/.claude/skills/react-ui-library/SKILL.md new file mode 100644 index 0000000..6e68d7d --- /dev/null +++ b/.claude/skills/react-ui-library/SKILL.md @@ -0,0 +1,174 @@ +```markdown +# react-ui-library Development Patterns + +> Auto-generated skill from repository analysis + +## Overview + +This skill teaches you how to contribute to the `react-ui-library` codebase, a TypeScript-based UI component library. You'll learn about its coding conventions, how to add or update components and documentation, improve accessibility, and follow best practices for commits and testing. The repository is organized for modularity and clarity, with a strong focus on documentation and accessibility. + +## Coding Conventions + +- **File Naming:** + Use `camelCase` for file and folder names. + ``` + packages/ui/src/components/form/formItem.tsx + docs/components/button.md + ``` + +- **Import Style:** + Use relative imports for modules within the codebase. + ```typescript + import { Button } from '../button' + import { useForm } from '../../hooks/useForm' + ``` + +- **Export Style:** + Use named exports for all components and utilities. + ```typescript + export { Button } + export { useForm } + ``` + +- **Commit Messages:** + Use prefixes like `feat:`, `fix:`, or `docs:` followed by a concise description (average 65 characters). + ``` + feat: add DatePicker component with range selection + fix: correct tab keyboard navigation in Tabs component + docs: update Table API documentation + ``` + +## Workflows + +### Add or Update Component Documentation +**Trigger:** When adding a new component or improving documentation for an existing component +**Command:** `/add-component-docs` + +1. Create or update one or more markdown files in `docs/components/`. +2. Optionally update `docs/.vitepress/config.ts` to register new docs or categories. +3. Optionally update `docs/components/overview.md` or related index files. + +**Example:** +```markdown + +# Button + +## API + +| Prop | Type | Description | +|--------|----------|-------------------| +| type | string | Button type | +| onClick| function | Click handler | + +## Playground + + +``` + +### Add New UI Component +**Trigger:** When adding a new UI component to the library +**Command:** `/add-ui-component` + +1. Create a new component file in `packages/ui/src/components//.tsx`. +2. Export the component in the corresponding `index.ts` file. +3. Optionally update related documentation in `docs/components/`. + +**Example:** +```typescript +// packages/ui/src/components/button/button.tsx +import React from 'react' + +export interface ButtonProps { + type?: 'primary' | 'default' + onClick?: () => void +} + +export const Button: React.FC = ({ type = 'default', onClick, children }) => ( + +) +``` + +```typescript +// packages/ui/src/components/button/index.ts +export { Button } from './button' +``` + +### Improve Accessibility or A11y +**Trigger:** When enhancing accessibility for components +**Command:** `/improve-a11y` + +1. Update one or more component files in `packages/ui/src/components/` to improve accessibility (ARIA attributes, keyboard support, etc.). +2. Update or add accessibility documentation in `docs/guide/accessibility.md`. +3. Optionally update `docs/.vitepress/config.ts` if new guide pages are added. + +**Example:** +```typescript +// packages/ui/src/components/button/button.tsx +export const Button: React.FC = ({ type = 'default', onClick, children }) => ( + +) +``` + +```markdown + +# Accessibility + +All interactive components support keyboard navigation and proper ARIA attributes. +``` + +### Feature or Bugfix in Component +**Trigger:** When enhancing or fixing a specific component +**Command:** `/feature-component` + +1. Edit the relevant component file in `packages/ui/src/components//.tsx`. +2. Commit with a `feat:` or `fix:` message. +3. Optionally merge via pull request. + +**Example:** +```typescript +// packages/ui/src/components/table/table.tsx +export const Table = ({ data }) => ( + + {/* ... */} +
+) +// Fix: Add missing keyboard navigation support +``` + +## Testing Patterns + +- **Test File Pattern:** + Test files use the pattern `*.test.*` (e.g., `button.test.tsx`). +- **Testing Framework:** + Not explicitly specified; check for common frameworks like Jest or Vitest. +- **Example Test File:** + ```typescript + // packages/ui/src/components/button/button.test.tsx + import { render, fireEvent } from '@testing-library/react' + import { Button } from './button' + + test('calls onClick when clicked', () => { + const handleClick = jest.fn() + const { getByText } = render() + fireEvent.click(getByText('Click')) + expect(handleClick).toHaveBeenCalled() + }) + ``` + +## Commands + +| Command | Purpose | +|----------------------|--------------------------------------------------------| +| /add-component-docs | Add or update documentation for a UI component | +| /add-ui-component | Add a new UI component to the library | +| /improve-a11y | Improve accessibility (a11y) for components | +| /feature-component | Add a feature or fix a bug in an existing component | +``` From 07b63f10925c8acee2960b763ee3e01a5b9c355a Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:39 +0000 Subject: [PATCH 03/14] feat: add react-ui-library ECC bundle (.agents/skills/react-ui-library/SKILL.md) --- .agents/skills/react-ui-library/SKILL.md | 174 +++++++++++++++++++++++ 1 file changed, 174 insertions(+) create mode 100644 .agents/skills/react-ui-library/SKILL.md diff --git a/.agents/skills/react-ui-library/SKILL.md b/.agents/skills/react-ui-library/SKILL.md new file mode 100644 index 0000000..6e68d7d --- /dev/null +++ b/.agents/skills/react-ui-library/SKILL.md @@ -0,0 +1,174 @@ +```markdown +# react-ui-library Development Patterns + +> Auto-generated skill from repository analysis + +## Overview + +This skill teaches you how to contribute to the `react-ui-library` codebase, a TypeScript-based UI component library. You'll learn about its coding conventions, how to add or update components and documentation, improve accessibility, and follow best practices for commits and testing. The repository is organized for modularity and clarity, with a strong focus on documentation and accessibility. + +## Coding Conventions + +- **File Naming:** + Use `camelCase` for file and folder names. + ``` + packages/ui/src/components/form/formItem.tsx + docs/components/button.md + ``` + +- **Import Style:** + Use relative imports for modules within the codebase. + ```typescript + import { Button } from '../button' + import { useForm } from '../../hooks/useForm' + ``` + +- **Export Style:** + Use named exports for all components and utilities. + ```typescript + export { Button } + export { useForm } + ``` + +- **Commit Messages:** + Use prefixes like `feat:`, `fix:`, or `docs:` followed by a concise description (average 65 characters). + ``` + feat: add DatePicker component with range selection + fix: correct tab keyboard navigation in Tabs component + docs: update Table API documentation + ``` + +## Workflows + +### Add or Update Component Documentation +**Trigger:** When adding a new component or improving documentation for an existing component +**Command:** `/add-component-docs` + +1. Create or update one or more markdown files in `docs/components/`. +2. Optionally update `docs/.vitepress/config.ts` to register new docs or categories. +3. Optionally update `docs/components/overview.md` or related index files. + +**Example:** +```markdown + +# Button + +## API + +| Prop | Type | Description | +|--------|----------|-------------------| +| type | string | Button type | +| onClick| function | Click handler | + +## Playground + + +``` + +### Add New UI Component +**Trigger:** When adding a new UI component to the library +**Command:** `/add-ui-component` + +1. Create a new component file in `packages/ui/src/components//.tsx`. +2. Export the component in the corresponding `index.ts` file. +3. Optionally update related documentation in `docs/components/`. + +**Example:** +```typescript +// packages/ui/src/components/button/button.tsx +import React from 'react' + +export interface ButtonProps { + type?: 'primary' | 'default' + onClick?: () => void +} + +export const Button: React.FC = ({ type = 'default', onClick, children }) => ( + +) +``` + +```typescript +// packages/ui/src/components/button/index.ts +export { Button } from './button' +``` + +### Improve Accessibility or A11y +**Trigger:** When enhancing accessibility for components +**Command:** `/improve-a11y` + +1. Update one or more component files in `packages/ui/src/components/` to improve accessibility (ARIA attributes, keyboard support, etc.). +2. Update or add accessibility documentation in `docs/guide/accessibility.md`. +3. Optionally update `docs/.vitepress/config.ts` if new guide pages are added. + +**Example:** +```typescript +// packages/ui/src/components/button/button.tsx +export const Button: React.FC = ({ type = 'default', onClick, children }) => ( + +) +``` + +```markdown + +# Accessibility + +All interactive components support keyboard navigation and proper ARIA attributes. +``` + +### Feature or Bugfix in Component +**Trigger:** When enhancing or fixing a specific component +**Command:** `/feature-component` + +1. Edit the relevant component file in `packages/ui/src/components//.tsx`. +2. Commit with a `feat:` or `fix:` message. +3. Optionally merge via pull request. + +**Example:** +```typescript +// packages/ui/src/components/table/table.tsx +export const Table = ({ data }) => ( + + {/* ... */} +
+) +// Fix: Add missing keyboard navigation support +``` + +## Testing Patterns + +- **Test File Pattern:** + Test files use the pattern `*.test.*` (e.g., `button.test.tsx`). +- **Testing Framework:** + Not explicitly specified; check for common frameworks like Jest or Vitest. +- **Example Test File:** + ```typescript + // packages/ui/src/components/button/button.test.tsx + import { render, fireEvent } from '@testing-library/react' + import { Button } from './button' + + test('calls onClick when clicked', () => { + const handleClick = jest.fn() + const { getByText } = render() + fireEvent.click(getByText('Click')) + expect(handleClick).toHaveBeenCalled() + }) + ``` + +## Commands + +| Command | Purpose | +|----------------------|--------------------------------------------------------| +| /add-component-docs | Add or update documentation for a UI component | +| /add-ui-component | Add a new UI component to the library | +| /improve-a11y | Improve accessibility (a11y) for components | +| /feature-component | Add a feature or fix a bug in an existing component | +``` From d9a291852ddcb8cc6457eb372c3fbca7cacd89d2 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:40 +0000 Subject: [PATCH 04/14] feat: add react-ui-library ECC bundle (.agents/skills/react-ui-library/agents/openai.yaml) --- .agents/skills/react-ui-library/agents/openai.yaml | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 .agents/skills/react-ui-library/agents/openai.yaml diff --git a/.agents/skills/react-ui-library/agents/openai.yaml b/.agents/skills/react-ui-library/agents/openai.yaml new file mode 100644 index 0000000..b543218 --- /dev/null +++ b/.agents/skills/react-ui-library/agents/openai.yaml @@ -0,0 +1,6 @@ +interface: + display_name: "React Ui Library" + short_description: "Repo-specific patterns and workflows for react-ui-library" + default_prompt: "Use the react-ui-library repo skill to follow existing architecture, testing, and workflow conventions." +policy: + allow_implicit_invocation: true \ No newline at end of file From 330813b73f8d1980134df967d29e745dec2a57aa Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:41 +0000 Subject: [PATCH 05/14] feat: add react-ui-library ECC bundle (.claude/identity.json) --- .claude/identity.json | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 .claude/identity.json diff --git a/.claude/identity.json b/.claude/identity.json new file mode 100644 index 0000000..9892a35 --- /dev/null +++ b/.claude/identity.json @@ -0,0 +1,14 @@ +{ + "version": "2.0", + "technicalLevel": "technical", + "preferredStyle": { + "verbosity": "moderate", + "codeComments": true, + "explanations": true + }, + "domains": [ + "typescript" + ], + "suggestedBy": "ecc-tools-repo-analysis", + "createdAt": "2026-06-30T10:54:30.106Z" +} \ No newline at end of file From b47212df510797d7ef1f15d15e8226fc3548d870 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:42 +0000 Subject: [PATCH 06/14] feat: add react-ui-library ECC bundle (.codex/config.toml) --- .codex/config.toml | 48 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 .codex/config.toml diff --git a/.codex/config.toml b/.codex/config.toml new file mode 100644 index 0000000..bc1ee67 --- /dev/null +++ b/.codex/config.toml @@ -0,0 +1,48 @@ +#:schema https://developers.openai.com/codex/config-schema.json + +# ECC Tools generated Codex baseline +approval_policy = "on-request" +sandbox_mode = "workspace-write" +web_search = "live" + +[mcp_servers.github] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-github"] + +[mcp_servers.context7] +command = "npx" +args = ["-y", "@upstash/context7-mcp@latest"] + +[mcp_servers.exa] +url = "https://mcp.exa.ai/mcp" + +[mcp_servers.memory] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-memory"] + +[mcp_servers.playwright] +command = "npx" +args = ["-y", "@playwright/mcp@latest", "--extension"] + +[mcp_servers.sequential-thinking] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-sequential-thinking"] + +[features] +multi_agent = true + +[agents] +max_threads = 6 +max_depth = 1 + +[agents.explorer] +description = "Read-only codebase explorer for gathering evidence before changes are proposed." +config_file = "agents/explorer.toml" + +[agents.reviewer] +description = "PR reviewer focused on correctness, security, and missing tests." +config_file = "agents/reviewer.toml" + +[agents.docs_researcher] +description = "Documentation specialist that verifies APIs, framework behavior, and release notes." +config_file = "agents/docs-researcher.toml" \ No newline at end of file From 135dc260e846ebddff7b7174b74efed7e91b2fae Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:43 +0000 Subject: [PATCH 07/14] feat: add react-ui-library ECC bundle (.codex/AGENTS.md) --- .codex/AGENTS.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 .codex/AGENTS.md diff --git a/.codex/AGENTS.md b/.codex/AGENTS.md new file mode 100644 index 0000000..812b0ee --- /dev/null +++ b/.codex/AGENTS.md @@ -0,0 +1,28 @@ +# ECC for Codex CLI + +This supplements the root `AGENTS.md` with a repo-local ECC baseline. + +## Repo Skill + +- Repo-generated Codex skill: `.agents/skills/react-ui-library/SKILL.md` +- Claude-facing companion skill: `.claude/skills/react-ui-library/SKILL.md` +- Keep user-specific credentials and private MCPs in `~/.codex/config.toml`, not in this repo. + +## MCP Baseline + +Treat `.codex/config.toml` as the default ECC-safe baseline for work in this repository. +The generated baseline enables GitHub, Context7, Exa, Memory, Playwright, and Sequential Thinking. + +## Multi-Agent Support + +- Explorer: read-only evidence gathering +- Reviewer: correctness, security, and regression review +- Docs researcher: API and release-note verification + +## Workflow Files + +- `.claude/commands/feature-development.md` +- `.claude/commands/add-or-update-component-documentation.md` +- `.claude/commands/add-new-ui-component.md` + +Use these workflow files as reusable task scaffolds when the detected repository workflows recur. \ No newline at end of file From 934d710ec0f46651088078e350d988dba0d3ac25 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:44 +0000 Subject: [PATCH 08/14] feat: add react-ui-library ECC bundle (.codex/agents/explorer.toml) --- .codex/agents/explorer.toml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 .codex/agents/explorer.toml diff --git a/.codex/agents/explorer.toml b/.codex/agents/explorer.toml new file mode 100644 index 0000000..732df7a --- /dev/null +++ b/.codex/agents/explorer.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "medium" +sandbox_mode = "read-only" + +developer_instructions = """ +Stay in exploration mode. +Trace the real execution path, cite files and symbols, and avoid proposing fixes unless the parent agent asks for them. +Prefer targeted search and file reads over broad scans. +""" \ No newline at end of file From 39779394d3e5cf49d9b83555af7340a510344b82 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:45 +0000 Subject: [PATCH 09/14] feat: add react-ui-library ECC bundle (.codex/agents/reviewer.toml) --- .codex/agents/reviewer.toml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 .codex/agents/reviewer.toml diff --git a/.codex/agents/reviewer.toml b/.codex/agents/reviewer.toml new file mode 100644 index 0000000..b13ed9c --- /dev/null +++ b/.codex/agents/reviewer.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "high" +sandbox_mode = "read-only" + +developer_instructions = """ +Review like an owner. +Prioritize correctness, security, behavioral regressions, and missing tests. +Lead with concrete findings and avoid style-only feedback unless it hides a real bug. +""" \ No newline at end of file From 929b3471b539f250af4c62c95a5b38863f86146d Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:46 +0000 Subject: [PATCH 10/14] feat: add react-ui-library ECC bundle (.codex/agents/docs-researcher.toml) --- .codex/agents/docs-researcher.toml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 .codex/agents/docs-researcher.toml diff --git a/.codex/agents/docs-researcher.toml b/.codex/agents/docs-researcher.toml new file mode 100644 index 0000000..0daae57 --- /dev/null +++ b/.codex/agents/docs-researcher.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "medium" +sandbox_mode = "read-only" + +developer_instructions = """ +Verify APIs, framework behavior, and release-note claims against primary documentation before changes land. +Cite the exact docs or file paths that support each claim. +Do not invent undocumented behavior. +""" \ No newline at end of file From 75b26fce5eb567d779694574fac71e787f6733a0 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:47 +0000 Subject: [PATCH 11/14] feat: add react-ui-library ECC bundle (.claude/homunculus/instincts/inherited/react-ui-library-instincts.yaml) --- .../inherited/react-ui-library-instincts.yaml | 520 ++++++++++++++++++ 1 file changed, 520 insertions(+) create mode 100644 .claude/homunculus/instincts/inherited/react-ui-library-instincts.yaml diff --git a/.claude/homunculus/instincts/inherited/react-ui-library-instincts.yaml b/.claude/homunculus/instincts/inherited/react-ui-library-instincts.yaml new file mode 100644 index 0000000..7a1a8e7 --- /dev/null +++ b/.claude/homunculus/instincts/inherited/react-ui-library-instincts.yaml @@ -0,0 +1,520 @@ +# Instincts generated from https://github.com/wyf027/react-ui-library +# Generated: 2026-06-30T10:54:30.106Z +# Version: 2.0 +# NOTE: This file supplements (does not replace) any existing curated instincts. +# High-confidence manually curated instincts should be preserved alongside these. + +--- +id: react-ui-library-commit-length +trigger: "when writing a commit message" +confidence: 0.6 +domain: git +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Commit Length + +## Action + +Write moderate-length commit messages (~65 characters) + +## Evidence + +- Average commit message length: 65 chars +- Based on 20 commits + +--- +id: react-ui-library-naming-files +trigger: "when creating a new file" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Naming Files + +## Action + +Use camelCase naming convention + +## Evidence + +- Analyzed file naming patterns in repository +- Dominant pattern: camelCase + +--- +id: react-ui-library-import-relative +trigger: "when importing modules" +confidence: 0.75 +domain: code-style +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Import Relative + +## Action + +Use relative imports for project files + +## Evidence + +- Import analysis shows relative import pattern +- Example: import { x } from '../lib/x' + +--- +id: react-ui-library-export-style +trigger: "when exporting from a module" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Export Style + +## Action + +Prefer named exports + +## Evidence + +- Export pattern analysis +- Dominant style: named + +--- +id: react-ui-library-arch-type-based +trigger: "when adding new code" +confidence: 0.8 +domain: architecture +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Arch Type Based + +## Action + +Place code in the appropriate type folder (components/, services/, utils/, etc.) + +## Evidence + +- Type-based module organization detected +- Folders: + +--- +id: react-ui-library-test-separate +trigger: "when writing tests" +confidence: 0.8 +domain: testing +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Test Separate + +## Action + +Place tests in the tests/ or __tests__/ directory, mirroring src structure + +## Evidence + +- Separate test directory pattern detected +- Tests live in dedicated test folders + +--- +id: react-ui-library-workflow-feature-development +trigger: "when implementing a new feature" +confidence: 0.9 +domain: workflow +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Workflow Feature Development + +## Action + +Follow the feature-development workflow: +1. Add feature implementation +2. Add tests for feature +3. Update documentation + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~20x per month +- Files: docs/components/*, docs/.vitepress/*, packages/ui/src/components/data/* + +--- +id: react-ui-library-workflow-add-or-update-component-documentation +trigger: "when doing add or update component documentation" +confidence: 0.65 +domain: workflow +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Workflow Add Or Update Component Documentation + +## Action + +Follow the add-or-update-component-documentation workflow: +1. Create or update one or more markdown files in docs/components/ +2. Optionally update docs/.vitepress/config.ts to register new docs or categories +3. Optionally update docs/components/overview.md or related index files + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~3x per month +- Files: docs/components/*.md, docs/.vitepress/config.ts, docs/components/overview.md + +--- +id: react-ui-library-workflow-add-new-ui-component +trigger: "when doing add new ui component" +confidence: 0.6 +domain: workflow +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Workflow Add New Ui Component + +## Action + +Follow the add-new-ui-component workflow: +1. Create new component file in packages/ui/src/components//.tsx +2. Export the component in the corresponding index.ts file +3. Optionally update related documentation in docs/components/ + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~2x per month +- Files: packages/ui/src/components/*/*.tsx, packages/ui/src/components/*/index.ts, docs/components/*.md + +--- +id: react-ui-library-workflow-improve-accessibility-or-a11y +trigger: "when doing improve accessibility or a11y" +confidence: 0.55 +domain: workflow +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Workflow Improve Accessibility Or A11y + +## Action + +Follow the improve-accessibility-or-a11y workflow: +1. Update one or more component files in packages/ui/src/components/ to improve a11y +2. Update or add accessibility documentation in docs/guide/accessibility.md +3. Optionally update docs/.vitepress/config.ts if new guide pages are added + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~1x per month +- Files: packages/ui/src/components/*/*.tsx, docs/guide/accessibility.md, docs/.vitepress/config.ts + +--- +id: react-ui-library-workflow-feature-or-bugfix-in-component +trigger: "when doing feature or bugfix in component" +confidence: 0.6 +domain: workflow +source: repo-analysis +source_repo: https://github.com/wyf027/react-ui-library +--- + +# React Ui Library Workflow Feature Or Bugfix In Component + +## Action + +Follow the feature-or-bugfix-in-component workflow: +1. Edit the relevant component file in packages/ui/src/components//.tsx +2. Commit with a feature or fix message +3. Optionally merge via pull request + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~2x per month +- Files: packages/ui/src/components/*/*.tsx + +--- +id: react-ui-library-naming-files-camelCase +trigger: "When creating a new file (component, utility, etc.) in the codebase" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Naming Files CamelCase + +## Action + +Name the file using camelCase (e.g., buttonGroup.tsx, formUtils.ts) + +## Evidence + +- Pattern in namingConventions.files +- Observed in packages/ui/src/components/*/*.tsx + +--- +id: react-ui-library-naming-functions-camelCase +trigger: "When defining a new function" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Naming Functions CamelCase + +## Action + +Name the function using camelCase (e.g., handleClick, getOptions) + +## Evidence + +- Pattern in namingConventions.functions + +--- +id: react-ui-library-naming-classes-PascalCase +trigger: "When creating a new class (e.g., React component class)" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Naming Classes PascalCase + +## Action + +Name the class using PascalCase (e.g., ButtonGroup, FormProvider) + +## Evidence + +- Pattern in namingConventions.classes + +--- +id: react-ui-library-naming-constants-SCREAMING_SNAKE_CASE +trigger: "When defining a constant" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Naming Constants SCREAMING_SNAKE_CASE + +## Action + +Name the constant using SCREAMING_SNAKE_CASE (e.g., DEFAULT_TIMEOUT) + +## Evidence + +- Pattern in namingConventions.constants + +--- +id: react-ui-library-imports-relative +trigger: "When importing modules within the codebase" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Imports Relative + +## Action + +Use relative import paths (e.g., import Button from '../Button') + +## Evidence + +- Pattern in importStyle + +--- +id: react-ui-library-exports-named +trigger: "When exporting modules or functions" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Exports Named + +## Action + +Use named exports (e.g., export { Button }) + +## Evidence + +- Pattern in exportStyle + +--- +id: react-ui-library-testing-location-separate +trigger: "When adding tests for a component or module" +confidence: 0.7 +domain: testing +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Testing Location Separate + +## Action + +Place test files in a separate test directory, not alongside source files + +## Evidence + +- architecture.testLocation is 'separate' + +--- +id: react-ui-library-testing-feature-sequence +trigger: "When implementing a new feature" +confidence: 0.8 +domain: testing +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Testing Feature Sequence + +## Action + +Write tests for the feature after implementation and before updating documentation + +## Evidence + +- feature-development workflow: 'Add feature implementation' → 'Add tests for feature' → 'Update documentation' + +--- +id: react-ui-library-git-commit-prefix +trigger: "When writing a commit message" +confidence: 0.9 +domain: git +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Git Commit Prefix + +## Action + +Use a prefix indicating the type of change: 'docs:', 'feat:', or 'fix:' + +## Evidence + +- commits.prefixes +- Examples: 'docs: add Button...' +- 'feat: add missing AntD-aligned components...' +- 'fix(a11y): focus dropdown options...' + +--- +id: react-ui-library-git-commit-length +trigger: "When writing a commit message" +confidence: 0.7 +domain: git +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Git Commit Length + +## Action + +Keep the commit message concise, around 65 characters on average + +## Evidence + +- commits.averageLength is 65 + +--- +id: react-ui-library-workflow-add-or-update-component-docs +trigger: "When a new component is added or existing component documentation needs improvement" +confidence: 0.95 +domain: workflow +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Workflow Add Or Update Component Docs + +## Action + +Create or update markdown files in docs/components/, and optionally update docs/.vitepress/config.ts and docs/components/overview.md + +## Evidence + +- add-or-update-component-documentation workflow +- Examples: 'docs: add Button, Icon, and Typography component pages' + +--- +id: react-ui-library-workflow-add-new-ui-component +trigger: "When a new UI component is to be implemented" +confidence: 0.9 +domain: workflow +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Workflow Add New Ui Component + +## Action + +Create a new .tsx file in packages/ui/src/components//, export it in index.ts, and optionally update docs/components/ + +## Evidence + +- add-new-ui-component workflow +- Examples: 'feat: add missing AntD-aligned components...' + +--- +id: react-ui-library-workflow-improve-accessibility +trigger: "When accessibility (a11y) improvements are needed for components" +confidence: 0.8 +domain: workflow +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Workflow Improve Accessibility + +## Action + +Update component files in packages/ui/src/components/ to improve a11y, update docs/guide/accessibility.md, and optionally update docs/.vitepress/config.ts + +## Evidence + +- improve-accessibility-or-a11y workflow +- Examples: 'fix(a11y): focus dropdown options and isolate form ids' + +--- +id: react-ui-library-workflow-feature-or-bugfix-in-component +trigger: "When a feature is added or a bug is fixed in an existing component" +confidence: 0.85 +domain: workflow +source: repo-analysis +source_repo: wyf027/react-ui-library +--- + +# React Ui Library Workflow Feature Or Bugfix In Component + +## Action + +Edit the relevant .tsx file in packages/ui/src/components//, commit with a feature or fix message, and optionally merge via pull request + +## Evidence + +- feature-or-bugfix-in-component workflow +- Examples: 'fix(a11y): focus dropdown options and isolate form ids' + From b0edbcba978910f3fb6999f9896f06a55492e172 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:48 +0000 Subject: [PATCH 12/14] feat: add react-ui-library ECC bundle (.claude/commands/feature-development.md) --- .claude/commands/feature-development.md | 37 +++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 .claude/commands/feature-development.md diff --git a/.claude/commands/feature-development.md b/.claude/commands/feature-development.md new file mode 100644 index 0000000..ed6560a --- /dev/null +++ b/.claude/commands/feature-development.md @@ -0,0 +1,37 @@ +--- +name: feature-development +description: Workflow command scaffold for feature-development in react-ui-library. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /feature-development + +Use this workflow when working on **feature-development** in `react-ui-library`. + +## Goal + +Standard feature implementation workflow + +## Common Files + +- `docs/components/*` +- `docs/.vitepress/*` +- `packages/ui/src/components/data/*` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Add feature implementation +- Add tests for feature +- Update documentation + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file From 65faba7cd6e051c440b8691cf75b6f20b75ef7b5 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:49 +0000 Subject: [PATCH 13/14] feat: add react-ui-library ECC bundle (.claude/commands/add-or-update-component-documentation.md) --- .../add-or-update-component-documentation.md | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 .claude/commands/add-or-update-component-documentation.md diff --git a/.claude/commands/add-or-update-component-documentation.md b/.claude/commands/add-or-update-component-documentation.md new file mode 100644 index 0000000..497c2c8 --- /dev/null +++ b/.claude/commands/add-or-update-component-documentation.md @@ -0,0 +1,37 @@ +--- +name: add-or-update-component-documentation +description: Workflow command scaffold for add-or-update-component-documentation in react-ui-library. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /add-or-update-component-documentation + +Use this workflow when working on **add-or-update-component-documentation** in `react-ui-library`. + +## Goal + +Adds or updates documentation pages for UI components, typically in VitePress markdown format, often including API tables and playground examples. + +## Common Files + +- `docs/components/*.md` +- `docs/.vitepress/config.ts` +- `docs/components/overview.md` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Create or update one or more markdown files in docs/components/ +- Optionally update docs/.vitepress/config.ts to register new docs or categories +- Optionally update docs/components/overview.md or related index files + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file From 98dee0a52b5aad483eac132f2f889d603928e444 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 10:54:50 +0000 Subject: [PATCH 14/14] feat: add react-ui-library ECC bundle (.claude/commands/add-new-ui-component.md) --- .claude/commands/add-new-ui-component.md | 37 ++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 .claude/commands/add-new-ui-component.md diff --git a/.claude/commands/add-new-ui-component.md b/.claude/commands/add-new-ui-component.md new file mode 100644 index 0000000..dabbdc0 --- /dev/null +++ b/.claude/commands/add-new-ui-component.md @@ -0,0 +1,37 @@ +--- +name: add-new-ui-component +description: Workflow command scaffold for add-new-ui-component in react-ui-library. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /add-new-ui-component + +Use this workflow when working on **add-new-ui-component** in `react-ui-library`. + +## Goal + +Implements a new UI component in the codebase, typically matching Ant Design API patterns, and exposes it via index files. + +## Common Files + +- `packages/ui/src/components/*/*.tsx` +- `packages/ui/src/components/*/index.ts` +- `docs/components/*.md` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Create new component file in packages/ui/src/components//.tsx +- Export the component in the corresponding index.ts file +- Optionally update related documentation in docs/components/ + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file