From 294c0475c57eba035690aa959e892a3900ad1e34 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:02 +0000
Subject: [PATCH 01/13] feat: add refined-github-projects ECC bundle
 (.claude/ecc-tools.json)

---
 .claude/ecc-tools.json | 273 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 273 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..abbd4f0
--- /dev/null
+++ b/.claude/ecc-tools.json
@@ -0,0 +1,273 @@
+{
+  "version": "1.3",
+  "schemaVersion": "1.0",
+  "generatedBy": "ecc-tools",
+  "generatedAt": "2026-06-14T13:40:37.932Z",
+  "repo": "https://github.com/fathiraz/refined-github-projects",
+  "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/refined-github-projects/SKILL.md",
+    ".agents/skills/refined-github-projects/SKILL.md",
+    ".agents/skills/refined-github-projects/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/refined-github-projects-instincts.yaml",
+    ".claude/commands/modal-shell-refactor-or-bugfix.md",
+    ".claude/commands/sprint-ui-enhancement-or-bugfix.md"
+  ],
+  "packageFiles": {
+    "runtime-core": [
+      ".claude/skills/refined-github-projects/SKILL.md",
+      ".agents/skills/refined-github-projects/SKILL.md",
+      ".agents/skills/refined-github-projects/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/refined-github-projects-instincts.yaml"
+    ],
+    "workflow-pack": [
+      ".claude/commands/modal-shell-refactor-or-bugfix.md",
+      ".claude/commands/sprint-ui-enhancement-or-bugfix.md"
+    ]
+  },
+  "moduleFiles": {
+    "runtime-core": [
+      ".claude/skills/refined-github-projects/SKILL.md",
+      ".agents/skills/refined-github-projects/SKILL.md",
+      ".agents/skills/refined-github-projects/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/refined-github-projects-instincts.yaml"
+    ],
+    "workflow-pack": [
+      ".claude/commands/modal-shell-refactor-or-bugfix.md",
+      ".claude/commands/sprint-ui-enhancement-or-bugfix.md"
+    ]
+  },
+  "files": [
+    {
+      "moduleId": "runtime-core",
+      "path": ".claude/skills/refined-github-projects/SKILL.md",
+      "description": "Repository-specific Claude Code skill generated from git history."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".agents/skills/refined-github-projects/SKILL.md",
+      "description": "Codex-facing copy of the generated repository skill."
+    },
+    {
+      "moduleId": "runtime-core",
+      "path": ".agents/skills/refined-github-projects/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/refined-github-projects-instincts.yaml",
+      "description": "Continuous-learning instincts derived from repository patterns."
+    },
+    {
+      "moduleId": "workflow-pack",
+      "path": ".claude/commands/modal-shell-refactor-or-bugfix.md",
+      "description": "Workflow command scaffold for modal-shell-refactor-or-bugfix."
+    },
+    {
+      "moduleId": "workflow-pack",
+      "path": ".claude/commands/sprint-ui-enhancement-or-bugfix.md",
+      "description": "Workflow command scaffold for sprint-ui-enhancement-or-bugfix."
+    }
+  ],
+  "workflows": [
+    {
+      "command": "modal-shell-refactor-or-bugfix",
+      "path": ".claude/commands/modal-shell-refactor-or-bugfix.md"
+    },
+    {
+      "command": "sprint-ui-enhancement-or-bugfix",
+      "path": ".claude/commands/sprint-ui-enhancement-or-bugfix.md"
+    }
+  ],
+  "adapters": {
+    "claudeCode": {
+      "skillPath": ".claude/skills/refined-github-projects/SKILL.md",
+      "identityPath": ".claude/identity.json",
+      "commandPaths": [
+        ".claude/commands/modal-shell-refactor-or-bugfix.md",
+        ".claude/commands/sprint-ui-enhancement-or-bugfix.md"
+      ]
+    },
+    "codex": {
+      "configPath": ".codex/config.toml",
+      "agentsGuidePath": ".codex/AGENTS.md",
+      "skillPath": ".agents/skills/refined-github-projects/SKILL.md"
+    }
+  }
+}
\ No newline at end of file

From 5d1cc7aa523d68e3e16b9a51e47d65b21dd04779 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:03 +0000
Subject: [PATCH 02/13] feat: add refined-github-projects ECC bundle
 (.claude/skills/refined-github-projects/SKILL.md)

---
 .../skills/refined-github-projects/SKILL.md   | 104 ++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 .claude/skills/refined-github-projects/SKILL.md

diff --git a/.claude/skills/refined-github-projects/SKILL.md b/.claude/skills/refined-github-projects/SKILL.md
new file mode 100644
index 0000000..35ca339
--- /dev/null
+++ b/.claude/skills/refined-github-projects/SKILL.md
@@ -0,0 +1,104 @@
+```markdown
+# refined-github-projects Development Patterns
+
+> Auto-generated skill from repository analysis
+
+## Overview
+
+This skill teaches you the core development patterns and workflows used in the `refined-github-projects` TypeScript codebase. You'll learn the project's coding conventions, how to approach common UI refactorings and enhancements (especially for modals and sprint features), and how to write and organize tests. This guide is ideal for contributors aiming to maintain consistency and efficiency in this repository.
+
+## Coding Conventions
+
+- **Language:** TypeScript
+- **Framework:** None (vanilla React/TS)
+- **File Naming:** Use kebab-case for all file names.
+  - Example: `bulk-actions-bar.tsx`, `modal-shell.tsx`
+- **Import Style:** Use alias imports for modules.
+  ```typescript
+  import { ModalShell } from '@/ui/modal-shell'
+  ```
+- **Export Style:** Use named exports (avoid default exports).
+  ```typescript
+  // Good
+  export function BulkCloseModal() { ... }
+
+  // Avoid
+  // export default BulkCloseModal;
+  ```
+- **Commit Messages:** Follow conventional commits with type prefixes such as `fix` or `refactor`.
+  - Example: `fix: correct modal closing behavior on escape key`
+  - Example: `refactor: consolidate sprint modal logic`
+
+## Workflows
+
+### Modal Shell Refactor or Bugfix
+**Trigger:** When you need to refactor, consolidate, or fix modal UI logic and behavior.  
+**Command:** `/refactor-modal-shell`
+
+1. **Update or Refactor Shared Modal Shell**
+   - Edit `src/ui/modal-shell.tsx` to improve or fix modal logic.
+2. **Update Individual Modal Components**
+   - Modify files like `src/features/bulk-actions-modals.tsx`, `src/features/bulk-close-modal.tsx`, or any `src/features/bulk-*-modal.tsx` as needed.
+3. **Update or Add Tests**
+   - Ensure modal logic is covered in tests such as `src/ui/__tests__/modal-shell.test.tsx` and `src/features/__tests__/*.test.tsx`.
+4. **Update Related UI or Utility Files**
+   - Adjust supporting files like `src/lib/modal-factory.tsx` or `src/features/bulk-actions-bar.tsx` if modal usage changes.
+
+**Example:**
+```typescript
+// src/ui/modal-shell.tsx
+export function ModalShell({ isOpen, onClose, children }) {
+  if (!isOpen) return null;
+  return (
+    <div className="modal-backdrop" onClick={onClose}>
+      <div className="modal-content">{children}</div>
+    </div>
+  );
+}
+```
+
+### Sprint UI Enhancement or Bugfix
+**Trigger:** When you want to update, fix, or enhance sprint UI features or their underlying utilities.  
+**Command:** `/update-sprint-ui`
+
+1. **Modify Sprint UI Components**
+   - Edit files like `src/features/sprint-modal.tsx`, `src/features/sprint-progress-view.tsx`, or any `src/features/sprint-*.tsx`.
+2. **Update Sprint Utility Files and Tests**
+   - Change logic in `src/features/sprint-settings-utils.ts` and ensure coverage in `src/features/sprint-settings-utils.test.ts`.
+3. **Update Injection Points or Widgets**
+   - Adjust files such as `src/features/sprint-injections.tsx` and `src/features/sprint-table-widget.tsx` to reflect UI or logic changes.
+
+**Example:**
+```typescript
+// src/features/sprint-settings-utils.ts
+export function calculateSprintProgress(issues: Issue[]) {
+  const completed = issues.filter(i => i.closed).length;
+  return completed / issues.length;
+}
+```
+
+## Testing Patterns
+
+- **Framework:** [Vitest](https://vitest.dev/)
+- **Test File Pattern:** Name test files as `*.test.tsx` and place them alongside or within a `__tests__` directory.
+- **Test Example:**
+  ```typescript
+  // src/ui/__tests__/modal-shell.test.tsx
+  import { render } from '@testing-library/react'
+  import { ModalShell } from '../modal-shell'
+
+  test('renders children when open', () => {
+    const { getByText } = render(
+      <ModalShell isOpen={true} onClose={() => {}}>Hello</ModalShell>
+    )
+    expect(getByText('Hello')).toBeInTheDocument()
+  })
+  ```
+
+## Commands
+
+| Command                | Purpose                                                      |
+|------------------------|--------------------------------------------------------------|
+| /refactor-modal-shell  | Start a modal shell refactor or bugfix workflow              |
+| /update-sprint-ui      | Begin a sprint UI enhancement or bugfix workflow             |
+```

From 098136d73b1cac6e3cafd10ae536185da2106718 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:04 +0000
Subject: [PATCH 03/13] feat: add refined-github-projects ECC bundle
 (.agents/skills/refined-github-projects/SKILL.md)

---
 .../skills/refined-github-projects/SKILL.md   | 104 ++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 .agents/skills/refined-github-projects/SKILL.md

diff --git a/.agents/skills/refined-github-projects/SKILL.md b/.agents/skills/refined-github-projects/SKILL.md
new file mode 100644
index 0000000..35ca339
--- /dev/null
+++ b/.agents/skills/refined-github-projects/SKILL.md
@@ -0,0 +1,104 @@
+```markdown
+# refined-github-projects Development Patterns
+
+> Auto-generated skill from repository analysis
+
+## Overview
+
+This skill teaches you the core development patterns and workflows used in the `refined-github-projects` TypeScript codebase. You'll learn the project's coding conventions, how to approach common UI refactorings and enhancements (especially for modals and sprint features), and how to write and organize tests. This guide is ideal for contributors aiming to maintain consistency and efficiency in this repository.
+
+## Coding Conventions
+
+- **Language:** TypeScript
+- **Framework:** None (vanilla React/TS)
+- **File Naming:** Use kebab-case for all file names.
+  - Example: `bulk-actions-bar.tsx`, `modal-shell.tsx`
+- **Import Style:** Use alias imports for modules.
+  ```typescript
+  import { ModalShell } from '@/ui/modal-shell'
+  ```
+- **Export Style:** Use named exports (avoid default exports).
+  ```typescript
+  // Good
+  export function BulkCloseModal() { ... }
+
+  // Avoid
+  // export default BulkCloseModal;
+  ```
+- **Commit Messages:** Follow conventional commits with type prefixes such as `fix` or `refactor`.
+  - Example: `fix: correct modal closing behavior on escape key`
+  - Example: `refactor: consolidate sprint modal logic`
+
+## Workflows
+
+### Modal Shell Refactor or Bugfix
+**Trigger:** When you need to refactor, consolidate, or fix modal UI logic and behavior.  
+**Command:** `/refactor-modal-shell`
+
+1. **Update or Refactor Shared Modal Shell**
+   - Edit `src/ui/modal-shell.tsx` to improve or fix modal logic.
+2. **Update Individual Modal Components**
+   - Modify files like `src/features/bulk-actions-modals.tsx`, `src/features/bulk-close-modal.tsx`, or any `src/features/bulk-*-modal.tsx` as needed.
+3. **Update or Add Tests**
+   - Ensure modal logic is covered in tests such as `src/ui/__tests__/modal-shell.test.tsx` and `src/features/__tests__/*.test.tsx`.
+4. **Update Related UI or Utility Files**
+   - Adjust supporting files like `src/lib/modal-factory.tsx` or `src/features/bulk-actions-bar.tsx` if modal usage changes.
+
+**Example:**
+```typescript
+// src/ui/modal-shell.tsx
+export function ModalShell({ isOpen, onClose, children }) {
+  if (!isOpen) return null;
+  return (
+    <div className="modal-backdrop" onClick={onClose}>
+      <div className="modal-content">{children}</div>
+    </div>
+  );
+}
+```
+
+### Sprint UI Enhancement or Bugfix
+**Trigger:** When you want to update, fix, or enhance sprint UI features or their underlying utilities.  
+**Command:** `/update-sprint-ui`
+
+1. **Modify Sprint UI Components**
+   - Edit files like `src/features/sprint-modal.tsx`, `src/features/sprint-progress-view.tsx`, or any `src/features/sprint-*.tsx`.
+2. **Update Sprint Utility Files and Tests**
+   - Change logic in `src/features/sprint-settings-utils.ts` and ensure coverage in `src/features/sprint-settings-utils.test.ts`.
+3. **Update Injection Points or Widgets**
+   - Adjust files such as `src/features/sprint-injections.tsx` and `src/features/sprint-table-widget.tsx` to reflect UI or logic changes.
+
+**Example:**
+```typescript
+// src/features/sprint-settings-utils.ts
+export function calculateSprintProgress(issues: Issue[]) {
+  const completed = issues.filter(i => i.closed).length;
+  return completed / issues.length;
+}
+```
+
+## Testing Patterns
+
+- **Framework:** [Vitest](https://vitest.dev/)
+- **Test File Pattern:** Name test files as `*.test.tsx` and place them alongside or within a `__tests__` directory.
+- **Test Example:**
+  ```typescript
+  // src/ui/__tests__/modal-shell.test.tsx
+  import { render } from '@testing-library/react'
+  import { ModalShell } from '../modal-shell'
+
+  test('renders children when open', () => {
+    const { getByText } = render(
+      <ModalShell isOpen={true} onClose={() => {}}>Hello</ModalShell>
+    )
+    expect(getByText('Hello')).toBeInTheDocument()
+  })
+  ```
+
+## Commands
+
+| Command                | Purpose                                                      |
+|------------------------|--------------------------------------------------------------|
+| /refactor-modal-shell  | Start a modal shell refactor or bugfix workflow              |
+| /update-sprint-ui      | Begin a sprint UI enhancement or bugfix workflow             |
+```

From a6d20a588e5128f999bb943e066653373284b72a Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:05 +0000
Subject: [PATCH 04/13] feat: add refined-github-projects ECC bundle
 (.agents/skills/refined-github-projects/agents/openai.yaml)

---
 .agents/skills/refined-github-projects/agents/openai.yaml | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 .agents/skills/refined-github-projects/agents/openai.yaml

diff --git a/.agents/skills/refined-github-projects/agents/openai.yaml b/.agents/skills/refined-github-projects/agents/openai.yaml
new file mode 100644
index 0000000..674159d
--- /dev/null
+++ b/.agents/skills/refined-github-projects/agents/openai.yaml
@@ -0,0 +1,6 @@
+interface:
+  display_name: "Refined Github Projects"
+  short_description: "Repo-specific patterns and workflows for refined-github-projects"
+  default_prompt: "Use the refined-github-projects repo skill to follow existing architecture, testing, and workflow conventions."
+policy:
+  allow_implicit_invocation: true
\ No newline at end of file

From 90e49699bb8d3a1933c48c11e6730b836413fd10 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:06 +0000
Subject: [PATCH 05/13] feat: add refined-github-projects 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..e201a0c
--- /dev/null
+++ b/.claude/identity.json
@@ -0,0 +1,14 @@
+{
+  "version": "2.0",
+  "technicalLevel": "technical",
+  "preferredStyle": {
+    "verbosity": "minimal",
+    "codeComments": true,
+    "explanations": true
+  },
+  "domains": [
+    "typescript"
+  ],
+  "suggestedBy": "ecc-tools-repo-analysis",
+  "createdAt": "2026-06-14T13:40:56.446Z"
+}
\ No newline at end of file

From 5a54caeb6347cf2fa90f2ae06be6c11b910b9547 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:07 +0000
Subject: [PATCH 06/13] feat: add refined-github-projects 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 dd039bf60317e678d2cc0dda475cb56f9698971f Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:08 +0000
Subject: [PATCH 07/13] feat: add refined-github-projects ECC bundle
 (.codex/AGENTS.md)

---
 .codex/AGENTS.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 .codex/AGENTS.md

diff --git a/.codex/AGENTS.md b/.codex/AGENTS.md
new file mode 100644
index 0000000..63e0ae6
--- /dev/null
+++ b/.codex/AGENTS.md
@@ -0,0 +1,27 @@
+# ECC for Codex CLI
+
+This supplements the root `AGENTS.md` with a repo-local ECC baseline.
+
+## Repo Skill
+
+- Repo-generated Codex skill: `.agents/skills/refined-github-projects/SKILL.md`
+- Claude-facing companion skill: `.claude/skills/refined-github-projects/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/modal-shell-refactor-or-bugfix.md`
+- `.claude/commands/sprint-ui-enhancement-or-bugfix.md`
+
+Use these workflow files as reusable task scaffolds when the detected repository workflows recur.
\ No newline at end of file

From b79e3220abdfd2f6bcf351c7436930d5f9ca224a Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:09 +0000
Subject: [PATCH 08/13] feat: add refined-github-projects 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 6c37f47eb1b7a3e3c28453b581407cdcb6f6f658 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:10 +0000
Subject: [PATCH 09/13] feat: add refined-github-projects 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 ca8345dc5368db7696b161a80f6bcbe34c9af20a Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:11 +0000
Subject: [PATCH 10/13] feat: add refined-github-projects 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 1c01b0db9a30214955d68177059095e68dffc499 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:12 +0000
Subject: [PATCH 11/13] feat: add refined-github-projects ECC bundle
 (.claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml)

---
 .../refined-github-projects-instincts.yaml    | 509 ++++++++++++++++++
 1 file changed, 509 insertions(+)
 create mode 100644 .claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml

diff --git a/.claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml b/.claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml
new file mode 100644
index 0000000..4e60341
--- /dev/null
+++ b/.claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml
@@ -0,0 +1,509 @@
+# Instincts generated from https://github.com/fathiraz/refined-github-projects
+# Generated: 2026-06-14T13:40:56.446Z
+# 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: refined-github-projects-commit-conventional
+trigger: "when writing a commit message"
+confidence: 0.85
+domain: git
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Commit Conventional
+
+## Action
+
+Use conventional commit format with prefixes: fix, refactor
+
+## Evidence
+
+- 3 commits analyzed
+- Detected conventional commit pattern
+- Examples: refactor(ui): consolidate bulk modals and sprint Primer shell, fix(pr): address cubic review on close reason, sprint prune, modal Escape
+
+---
+id: refined-github-projects-commit-length
+trigger: "when writing a commit message"
+confidence: 0.6
+domain: git
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Commit Length
+
+## Action
+
+Write moderate-length commit messages (~65 characters)
+
+## Evidence
+
+- Average commit message length: 65 chars
+- Based on 3 commits
+
+---
+id: refined-github-projects-naming-files
+trigger: "when creating a new file"
+confidence: 0.8
+domain: code-style
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Naming Files
+
+## Action
+
+Use kebab-case naming convention
+
+## Evidence
+
+- Analyzed file naming patterns in repository
+- Dominant pattern: kebab-case
+
+---
+id: refined-github-projects-import-alias
+trigger: "when importing modules"
+confidence: 0.85
+domain: code-style
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Import Alias
+
+## Action
+
+Use path aliases (@/, ~/) instead of relative imports
+
+## Evidence
+
+- Import analysis shows alias pattern
+- Example: import { x } from '@/lib/x'
+
+---
+id: refined-github-projects-export-style
+trigger: "when exporting from a module"
+confidence: 0.7
+domain: code-style
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Export Style
+
+## Action
+
+Prefer named exports
+
+## Evidence
+
+- Export pattern analysis
+- Dominant style: named
+
+---
+id: refined-github-projects-test-colocate
+trigger: "when writing tests"
+confidence: 0.85
+domain: testing
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Test Colocate
+
+## Action
+
+Place test file next to the source file (e.g., Button.test.tsx next to Button.tsx)
+
+## Evidence
+
+- Colocated test pattern detected
+- Tests live alongside source files
+
+---
+id: refined-github-projects-test-framework
+trigger: "when writing tests"
+confidence: 0.9
+domain: testing
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Test Framework
+
+## Action
+
+Use vitest as the test framework
+
+## Evidence
+
+- Test framework detected: vitest
+- File pattern: *.test.tsx
+
+---
+id: refined-github-projects-test-naming
+trigger: "when creating a test file"
+confidence: 0.85
+domain: testing
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Test Naming
+
+## Action
+
+Name test files using the pattern: *.test.tsx
+
+## Evidence
+
+- File pattern: *.test.tsx
+- Consistent across test files
+
+---
+id: refined-github-projects-test-mocking
+trigger: "when mocking dependencies in tests"
+confidence: 0.75
+domain: testing
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Test Mocking
+
+## Action
+
+Use vi.mock for mocking
+
+## Evidence
+
+- Mocking pattern detected: vi.mock
+- Consistent across test files
+
+---
+id: refined-github-projects-test-types
+trigger: "when planning tests for a feature"
+confidence: 0.7
+domain: testing
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Test Types
+
+## Action
+
+Write unit, integration tests to match project standards
+
+## Evidence
+
+- Test types detected: unit, integration
+- Coverage config: no
+
+---
+id: refined-github-projects-workflow-modal-shell-refactor-or-bugfix
+trigger: "when doing modal shell refactor or bugfix"
+confidence: 0.6
+domain: workflow
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Workflow Modal Shell Refactor Or Bugfix
+
+## Action
+
+Follow the modal-shell-refactor-or-bugfix workflow:
+1. Update or refactor shared modal shell (src/ui/modal-shell.tsx)
+2. Update individual modal components (src/features/bulk-*-modal.tsx, src/features/bulk-actions-modals.tsx)
+3. Update or add tests for modal shell or modal logic (src/ui/__tests__/modal-shell.test.tsx, src/features/__tests__/*.test.tsx)
+4. Update related UI or utility files as needed (e.g., src/lib/modal-factory.tsx, src/features/bulk-actions-bar.tsx)
+
+## Evidence
+
+- Workflow detected from commit patterns
+- Frequency: ~2x per month
+- Files: src/ui/modal-shell.tsx, src/features/bulk-actions-modals.tsx, src/features/bulk-close-modal.tsx
+
+---
+id: refined-github-projects-workflow-sprint-ui-enhancement-or-bugfix
+trigger: "when doing sprint ui enhancement or bugfix"
+confidence: 0.6
+domain: workflow
+source: repo-analysis
+source_repo: https://github.com/fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Workflow Sprint Ui Enhancement Or Bugfix
+
+## Action
+
+Follow the sprint-ui-enhancement-or-bugfix workflow:
+1. Modify sprint UI components (src/features/sprint-*.tsx)
+2. Update sprint utility files and add/modify their tests (src/features/sprint-settings-utils.ts, src/features/sprint-settings-utils.test.ts)
+3. Update injection points or widgets (src/features/sprint-injections.tsx, src/features/sprint-table-widget.tsx)
+
+## Evidence
+
+- Workflow detected from commit patterns
+- Frequency: ~2x per month
+- Files: src/features/sprint-injections.tsx, src/features/sprint-modal.tsx, src/features/sprint-progress-view.tsx
+
+---
+id: refined-github-projects-instinct-file-naming
+trigger: "When creating or renaming files in the codebase"
+confidence: 0.9
+domain: code-style
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct File Naming
+
+## Action
+
+Use kebab-case for all file names
+
+## Evidence
+
+- Pattern in codeStyle.namingConventions.files
+- Consistent kebab-case in src/features/bulk-actions-modals.tsx, src/ui/modal-shell.tsx
+
+---
+id: refined-github-projects-instinct-function-naming
+trigger: "When defining a new function"
+confidence: 0.9
+domain: code-style
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Function Naming
+
+## Action
+
+Use camelCase for function names
+
+## Evidence
+
+- Pattern in codeStyle.namingConventions.functions
+
+---
+id: refined-github-projects-instinct-class-naming
+trigger: "When creating a new class"
+confidence: 0.9
+domain: code-style
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Class Naming
+
+## Action
+
+Use PascalCase for class names
+
+## Evidence
+
+- Pattern in codeStyle.namingConventions.classes
+
+---
+id: refined-github-projects-instinct-constant-naming
+trigger: "When defining a constant"
+confidence: 0.9
+domain: code-style
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Constant Naming
+
+## Action
+
+Use SCREAMING_SNAKE_CASE for constant names
+
+## Evidence
+
+- Pattern in codeStyle.namingConventions.constants
+
+---
+id: refined-github-projects-instinct-import-style
+trigger: "When importing modules"
+confidence: 0.8
+domain: code-style
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Import Style
+
+## Action
+
+Use alias import style
+
+## Evidence
+
+- Pattern in codeStyle.importStyle
+
+---
+id: refined-github-projects-instinct-export-style
+trigger: "When exporting modules or functions"
+confidence: 0.8
+domain: code-style
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Export Style
+
+## Action
+
+Use named exports
+
+## Evidence
+
+- Pattern in codeStyle.exportStyle
+
+---
+id: refined-github-projects-instinct-test-file-pattern
+trigger: "When creating a test file"
+confidence: 0.9
+domain: testing
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Test File Pattern
+
+## Action
+
+Name the file with a .test.tsx suffix and colocate it with the code under test
+
+## Evidence
+
+- Pattern in testing.filePattern
+- Pattern in architecture.folderStructure.testLocation
+- Seen in src/ui/__tests__/modal-shell.test.tsx
+
+---
+id: refined-github-projects-instinct-testing-framework
+trigger: "When writing tests"
+confidence: 0.9
+domain: testing
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Testing Framework
+
+## Action
+
+Use vitest as the testing framework
+
+## Evidence
+
+- Pattern in testing.framework
+
+---
+id: refined-github-projects-instinct-mocking-style
+trigger: "When mocking modules in tests"
+confidence: 0.8
+domain: testing
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Mocking Style
+
+## Action
+
+Use vi.mock for mocking
+
+## Evidence
+
+- Pattern in testing.mockingStyle
+
+---
+id: refined-github-projects-instinct-test-types
+trigger: "When designing tests"
+confidence: 0.8
+domain: testing
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Test Types
+
+## Action
+
+Write both unit and integration tests as appropriate
+
+## Evidence
+
+- Pattern in testing.testTypes
+
+---
+id: refined-github-projects-instinct-git-commit-format
+trigger: "When writing a commit message"
+confidence: 0.9
+domain: git
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Git Commit Format
+
+## Action
+
+Use conventional commits with fix or refactor prefixes and a concise, descriptive message (~65 characters)
+
+## Evidence
+
+- Pattern in commits.type and commits.prefixes
+- Examples: 'refactor(ui): consolidate bulk modals and sprint Primer shell', 'fix(pr): address cubic review on close reason, sprint prune, modal Escape'
+
+---
+id: refined-github-projects-instinct-modal-shell-workflow
+trigger: "When refactoring or fixing modal-related UI components"
+confidence: 0.9
+domain: workflow
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Modal Shell Workflow
+
+## Action
+
+Update shared modal shell, update individual modal components, update/add modal tests, and update related UI/util files
+
+## Evidence
+
+- Workflow: modal-shell-refactor-or-bugfix
+- Pattern in commit sequence and files: src/ui/modal-shell.tsx, src/features/bulk-*-modal.tsx, src/ui/__tests__/modal-shell.test.tsx
+
+---
+id: refined-github-projects-instinct-sprint-ui-workflow
+trigger: "When enhancing or fixing sprint-related UI features or utilities"
+confidence: 0.85
+domain: workflow
+source: repo-analysis
+source_repo: fathiraz/refined-github-projects
+---
+
+# Refined Github Projects Instinct Sprint Ui Workflow
+
+## Action
+
+Modify sprint UI components, update sprint utility files and their tests, update injection points or widgets
+
+## Evidence
+
+- Workflow: sprint-ui-enhancement-or-bugfix
+- Pattern in commit sequence and files: src/features/sprint-*.tsx, src/features/sprint-settings-utils.ts, src/features/sprint-injections.tsx
+

From a043b89d635d2c74c8e7df9d11476c9bced4b9bd Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:13 +0000
Subject: [PATCH 12/13] feat: add refined-github-projects ECC bundle
 (.claude/commands/modal-shell-refactor-or-bugfix.md)

---
 .../modal-shell-refactor-or-bugfix.md         | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 .claude/commands/modal-shell-refactor-or-bugfix.md

diff --git a/.claude/commands/modal-shell-refactor-or-bugfix.md b/.claude/commands/modal-shell-refactor-or-bugfix.md
new file mode 100644
index 0000000..86eb557
--- /dev/null
+++ b/.claude/commands/modal-shell-refactor-or-bugfix.md
@@ -0,0 +1,41 @@
+---
+name: modal-shell-refactor-or-bugfix
+description: Workflow command scaffold for modal-shell-refactor-or-bugfix in refined-github-projects.
+allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
+---
+
+# /modal-shell-refactor-or-bugfix
+
+Use this workflow when working on **modal-shell-refactor-or-bugfix** in `refined-github-projects`.
+
+## Goal
+
+Refactoring or fixing modal-related UI components by updating shared modal shells, related modal components, and their tests.
+
+## Common Files
+
+- `src/ui/modal-shell.tsx`
+- `src/features/bulk-actions-modals.tsx`
+- `src/features/bulk-close-modal.tsx`
+- `src/features/bulk-actions-bar.tsx`
+- `src/features/bulk-*-modal.tsx`
+- `src/ui/__tests__/modal-shell.test.tsx`
+
+## 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
+
+- Update or refactor shared modal shell (src/ui/modal-shell.tsx)
+- Update individual modal components (src/features/bulk-*-modal.tsx, src/features/bulk-actions-modals.tsx)
+- Update or add tests for modal shell or modal logic (src/ui/__tests__/modal-shell.test.tsx, src/features/__tests__/*.test.tsx)
+- Update related UI or utility files as needed (e.g., src/lib/modal-factory.tsx, src/features/bulk-actions-bar.tsx)
+
+## 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 069461b9f12cccdf7598c3c3294f7708125899c7 Mon Sep 17 00:00:00 2001
From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com>
Date: Sun, 14 Jun 2026 13:41:14 +0000
Subject: [PATCH 13/13] feat: add refined-github-projects ECC bundle
 (.claude/commands/sprint-ui-enhancement-or-bugfix.md)

---
 .../sprint-ui-enhancement-or-bugfix.md        | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 .claude/commands/sprint-ui-enhancement-or-bugfix.md

diff --git a/.claude/commands/sprint-ui-enhancement-or-bugfix.md b/.claude/commands/sprint-ui-enhancement-or-bugfix.md
new file mode 100644
index 0000000..e3988da
--- /dev/null
+++ b/.claude/commands/sprint-ui-enhancement-or-bugfix.md
@@ -0,0 +1,40 @@
+---
+name: sprint-ui-enhancement-or-bugfix
+description: Workflow command scaffold for sprint-ui-enhancement-or-bugfix in refined-github-projects.
+allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
+---
+
+# /sprint-ui-enhancement-or-bugfix
+
+Use this workflow when working on **sprint-ui-enhancement-or-bugfix** in `refined-github-projects`.
+
+## Goal
+
+Making enhancements or bugfixes to sprint-related UI components and utilities, often in conjunction with modal changes.
+
+## Common Files
+
+- `src/features/sprint-injections.tsx`
+- `src/features/sprint-modal.tsx`
+- `src/features/sprint-progress-view.tsx`
+- `src/features/sprint-settings-utils.ts`
+- `src/features/sprint-settings-utils.test.ts`
+- `src/features/sprint-settings-view.tsx`
+
+## 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
+
+- Modify sprint UI components (src/features/sprint-*.tsx)
+- Update sprint utility files and add/modify their tests (src/features/sprint-settings-utils.ts, src/features/sprint-settings-utils.test.ts)
+- Update injection points or widgets (src/features/sprint-injections.tsx, src/features/sprint-table-widget.tsx)
+
+## 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