From e3b153f10b22c0e9f4b1d0ee761a66c2bf3a3b7e Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:17:50 +0000 Subject: [PATCH 01/11] feat: add TYPESCRIPT ECC bundle (.claude/ecc-tools.json) --- .claude/ecc-tools.json | 227 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 227 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..7f37983 --- /dev/null +++ b/.claude/ecc-tools.json @@ -0,0 +1,227 @@ +{ + "version": "1.3", + "schemaVersion": "1.0", + "generatedBy": "ecc-tools", + "generatedAt": "2026-05-21T18:17:20.136Z", + "repo": "https://github.com/TaiChi112/TYPESCRIPT", + "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": "core", + "recommended": "core", + "effective": "core", + "requestedAlias": "core", + "recommendedAlias": "core", + "effectiveAlias": "core" + }, + "requestedProfile": "core", + "profile": "core", + "recommendedProfile": "core", + "effectiveProfile": "core", + "tier": "free", + "requestedComponents": [ + "repo-baseline" + ], + "selectedComponents": [ + "repo-baseline" + ], + "requestedAddComponents": [], + "requestedRemoveComponents": [], + "blockedRemovalComponents": [], + "tierFilteredComponents": [], + "requestedRootPackages": [ + "runtime-core" + ], + "selectedRootPackages": [ + "runtime-core" + ], + "requestedPackages": [ + "runtime-core" + ], + "requestedAddPackages": [], + "requestedRemovePackages": [], + "selectedPackages": [ + "runtime-core" + ], + "packages": [ + "runtime-core" + ], + "blockedRemovalPackages": [], + "tierFilteredRootPackages": [], + "tierFilteredPackages": [], + "conflictingPackages": [], + "dependencyGraph": { + "runtime-core": [] + }, + "resolutionOrder": [ + "runtime-core" + ], + "requestedModules": [ + "runtime-core" + ], + "selectedModules": [ + "runtime-core" + ], + "modules": [ + "runtime-core" + ], + "managedFiles": [ + ".claude/skills/TYPESCRIPT/SKILL.md", + ".agents/skills/TYPESCRIPT/SKILL.md", + ".agents/skills/TYPESCRIPT/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/TYPESCRIPT-instincts.yaml" + ], + "packageFiles": { + "runtime-core": [ + ".claude/skills/TYPESCRIPT/SKILL.md", + ".agents/skills/TYPESCRIPT/SKILL.md", + ".agents/skills/TYPESCRIPT/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/TYPESCRIPT-instincts.yaml" + ] + }, + "moduleFiles": { + "runtime-core": [ + ".claude/skills/TYPESCRIPT/SKILL.md", + ".agents/skills/TYPESCRIPT/SKILL.md", + ".agents/skills/TYPESCRIPT/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/TYPESCRIPT-instincts.yaml" + ] + }, + "files": [ + { + "moduleId": "runtime-core", + "path": ".claude/skills/TYPESCRIPT/SKILL.md", + "description": "Repository-specific Claude Code skill generated from git history." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/TYPESCRIPT/SKILL.md", + "description": "Codex-facing copy of the generated repository skill." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/TYPESCRIPT/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/TYPESCRIPT-instincts.yaml", + "description": "Continuous-learning instincts derived from repository patterns." + } + ], + "workflows": [], + "adapters": { + "claudeCode": { + "skillPath": ".claude/skills/TYPESCRIPT/SKILL.md", + "identityPath": ".claude/identity.json", + "commandPaths": [] + }, + "codex": { + "configPath": ".codex/config.toml", + "agentsGuidePath": ".codex/AGENTS.md", + "skillPath": ".agents/skills/TYPESCRIPT/SKILL.md" + } + } +} \ No newline at end of file From 849d388f9088c521b7a3ebded3cc110f16f5e028 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:17:51 +0000 Subject: [PATCH 02/11] feat: add TYPESCRIPT ECC bundle (.claude/skills/TYPESCRIPT/SKILL.md) --- .claude/skills/TYPESCRIPT/SKILL.md | 80 ++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 .claude/skills/TYPESCRIPT/SKILL.md diff --git a/.claude/skills/TYPESCRIPT/SKILL.md b/.claude/skills/TYPESCRIPT/SKILL.md new file mode 100644 index 0000000..0bed93a --- /dev/null +++ b/.claude/skills/TYPESCRIPT/SKILL.md @@ -0,0 +1,80 @@ +```markdown +# TYPESCRIPT Development Patterns + +> Auto-generated skill from repository analysis + +## Overview +This skill teaches the core development patterns and workflows found in a TypeScript codebase without a specific framework. It covers file organization, code style, commit conventions, and automated workflows—especially for managing dependencies across multiple packages. The guide also outlines how to write and organize tests in this environment. + +## Coding Conventions + +### File Naming +- **Style:** camelCase +- **Example:** + ``` + userService.ts + apiClient.test.ts + ``` + +### Imports +- **Style:** Relative imports +- **Example:** + ```typescript + import { fetchData } from './apiClient'; + ``` + +### Exports +- **Style:** Named exports +- **Example:** + ```typescript + export function fetchData() { ... } + export const API_URL = 'https://...'; + ``` + +### Commit Messages +- **Convention:** Conventional commits +- **Prefix example:** `build` +- **Example:** + ``` + build: update dependencies for axios and next in all packages + ``` + +## Workflows + +### Dependency Upgrade Across Multiple Packages +**Trigger:** When a new version of a dependency is released and needs to be applied across many packages/repos. +**Command:** `/upgrade-dependencies` + +1. **Detect outdated dependencies** in multiple project directories. +2. **Update `package.json`** with new dependency versions in each affected directory. +3. **Update lock files** (`package-lock.json`, `pnpm-lock.yaml`) in each directory. +4. **Commit all changes together** with a detailed changelog. + +**Files involved:** +- `**/package.json` +- `**/package-lock.json` +- `**/pnpm-lock.yaml` + +**Example:** +```sh +/upgrade-dependencies +``` +This command will automatically scan all packages, update dependencies, refresh lock files, and commit the changes. + +## Testing Patterns + +- **Framework:** Unknown (not detected) +- **File pattern:** `*.test.*` +- **Example:** + ``` + apiClient.test.ts + ``` +- **Typical structure:** Test files are placed alongside the modules they test, using the `.test.ts` suffix. + +## Commands + +| Command | Purpose | +|-----------------------|--------------------------------------------------------------| +| /upgrade-dependencies | Upgrade dependencies across all packages and update lockfiles | + +``` \ No newline at end of file From 5503142b8f4f2ac94cd42547a33b268c4619254f Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:17:53 +0000 Subject: [PATCH 03/11] feat: add TYPESCRIPT ECC bundle (.agents/skills/TYPESCRIPT/SKILL.md) --- .agents/skills/TYPESCRIPT/SKILL.md | 80 ++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 .agents/skills/TYPESCRIPT/SKILL.md diff --git a/.agents/skills/TYPESCRIPT/SKILL.md b/.agents/skills/TYPESCRIPT/SKILL.md new file mode 100644 index 0000000..0bed93a --- /dev/null +++ b/.agents/skills/TYPESCRIPT/SKILL.md @@ -0,0 +1,80 @@ +```markdown +# TYPESCRIPT Development Patterns + +> Auto-generated skill from repository analysis + +## Overview +This skill teaches the core development patterns and workflows found in a TypeScript codebase without a specific framework. It covers file organization, code style, commit conventions, and automated workflows—especially for managing dependencies across multiple packages. The guide also outlines how to write and organize tests in this environment. + +## Coding Conventions + +### File Naming +- **Style:** camelCase +- **Example:** + ``` + userService.ts + apiClient.test.ts + ``` + +### Imports +- **Style:** Relative imports +- **Example:** + ```typescript + import { fetchData } from './apiClient'; + ``` + +### Exports +- **Style:** Named exports +- **Example:** + ```typescript + export function fetchData() { ... } + export const API_URL = 'https://...'; + ``` + +### Commit Messages +- **Convention:** Conventional commits +- **Prefix example:** `build` +- **Example:** + ``` + build: update dependencies for axios and next in all packages + ``` + +## Workflows + +### Dependency Upgrade Across Multiple Packages +**Trigger:** When a new version of a dependency is released and needs to be applied across many packages/repos. +**Command:** `/upgrade-dependencies` + +1. **Detect outdated dependencies** in multiple project directories. +2. **Update `package.json`** with new dependency versions in each affected directory. +3. **Update lock files** (`package-lock.json`, `pnpm-lock.yaml`) in each directory. +4. **Commit all changes together** with a detailed changelog. + +**Files involved:** +- `**/package.json` +- `**/package-lock.json` +- `**/pnpm-lock.yaml` + +**Example:** +```sh +/upgrade-dependencies +``` +This command will automatically scan all packages, update dependencies, refresh lock files, and commit the changes. + +## Testing Patterns + +- **Framework:** Unknown (not detected) +- **File pattern:** `*.test.*` +- **Example:** + ``` + apiClient.test.ts + ``` +- **Typical structure:** Test files are placed alongside the modules they test, using the `.test.ts` suffix. + +## Commands + +| Command | Purpose | +|-----------------------|--------------------------------------------------------------| +| /upgrade-dependencies | Upgrade dependencies across all packages and update lockfiles | + +``` \ No newline at end of file From 46a4aff56a92966cef78f61a5fce81909e2222ec Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:17:54 +0000 Subject: [PATCH 04/11] feat: add TYPESCRIPT ECC bundle (.agents/skills/TYPESCRIPT/agents/openai.yaml) --- .agents/skills/TYPESCRIPT/agents/openai.yaml | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 .agents/skills/TYPESCRIPT/agents/openai.yaml diff --git a/.agents/skills/TYPESCRIPT/agents/openai.yaml b/.agents/skills/TYPESCRIPT/agents/openai.yaml new file mode 100644 index 0000000..63a545f --- /dev/null +++ b/.agents/skills/TYPESCRIPT/agents/openai.yaml @@ -0,0 +1,6 @@ +interface: + display_name: "TYPESCRIPT" + short_description: "Repo-specific patterns and workflows for TYPESCRIPT" + default_prompt: "Use the TYPESCRIPT repo skill to follow existing architecture, testing, and workflow conventions." +policy: + allow_implicit_invocation: true \ No newline at end of file From 889d89a0978845ef99e78384baffbc922b2e92da Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:17:56 +0000 Subject: [PATCH 05/11] feat: add TYPESCRIPT 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..0b27cb9 --- /dev/null +++ b/.claude/identity.json @@ -0,0 +1,14 @@ +{ + "version": "2.0", + "technicalLevel": "technical", + "preferredStyle": { + "verbosity": "detailed", + "codeComments": true, + "explanations": true + }, + "domains": [ + "typescript" + ], + "suggestedBy": "ecc-tools-repo-analysis", + "createdAt": "2026-05-21T18:17:41.452Z" +} \ No newline at end of file From 1950c4520347321d33090ee36d4f3073f11f10d9 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:17:57 +0000 Subject: [PATCH 06/11] feat: add TYPESCRIPT 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 d65885f1a86ecbff5710fa5b47aacae04bec93ab Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:17:58 +0000 Subject: [PATCH 07/11] feat: add TYPESCRIPT ECC bundle (.codex/AGENTS.md) --- .codex/AGENTS.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 .codex/AGENTS.md diff --git a/.codex/AGENTS.md b/.codex/AGENTS.md new file mode 100644 index 0000000..457e759 --- /dev/null +++ b/.codex/AGENTS.md @@ -0,0 +1,26 @@ +# ECC for Codex CLI + +This supplements the root `AGENTS.md` with a repo-local ECC baseline. + +## Repo Skill + +- Repo-generated Codex skill: `.agents/skills/TYPESCRIPT/SKILL.md` +- Claude-facing companion skill: `.claude/skills/TYPESCRIPT/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 + +- No dedicated workflow command files were generated for this repo. + +Use these workflow files as reusable task scaffolds when the detected repository workflows recur. \ No newline at end of file From 63b0b055e29ec04d98877532917ba0f1fbd24200 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:18:00 +0000 Subject: [PATCH 08/11] feat: add TYPESCRIPT 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 c478fb82a8e1a0ab07e174e6b16d74dbc73513e9 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:18:01 +0000 Subject: [PATCH 09/11] feat: add TYPESCRIPT 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 b7fda558259477a6f9d1f4b80a4d56aa6cb4f3e1 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:18:02 +0000 Subject: [PATCH 10/11] feat: add TYPESCRIPT 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 2a882311309f588ff51a8b7ed0041f198080c545 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 18:18:03 +0000 Subject: [PATCH 11/11] feat: add TYPESCRIPT ECC bundle (.claude/homunculus/instincts/inherited/TYPESCRIPT-instincts.yaml) --- .../inherited/TYPESCRIPT-instincts.yaml | 346 ++++++++++++++++++ 1 file changed, 346 insertions(+) create mode 100644 .claude/homunculus/instincts/inherited/TYPESCRIPT-instincts.yaml diff --git a/.claude/homunculus/instincts/inherited/TYPESCRIPT-instincts.yaml b/.claude/homunculus/instincts/inherited/TYPESCRIPT-instincts.yaml new file mode 100644 index 0000000..e832e56 --- /dev/null +++ b/.claude/homunculus/instincts/inherited/TYPESCRIPT-instincts.yaml @@ -0,0 +1,346 @@ +# Instincts generated from https://github.com/TaiChi112/TYPESCRIPT +# Generated: 2026-05-21T18:17:41.452Z +# 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: TYPESCRIPT-commit-conventional +trigger: "when writing a commit message" +confidence: 0.85 +domain: git +source: repo-analysis +source_repo: https://github.com/TaiChi112/TYPESCRIPT +--- + +# TYPESCRIPT Commit Conventional + +## Action + +Use conventional commit format with prefixes: build + +## Evidence + +- 1 commits analyzed +- Detected conventional commit pattern +- Examples: build(deps): bump the npm_and_yarn group across 30 directories with 3 updates + +--- +id: TYPESCRIPT-commit-length +trigger: "when writing a commit message" +confidence: 0.6 +domain: git +source: repo-analysis +source_repo: https://github.com/TaiChi112/TYPESCRIPT +--- + +# TYPESCRIPT Commit Length + +## Action + +Write moderate-length commit messages (~77 characters) + +## Evidence + +- Average commit message length: 77 chars +- Based on 1 commits + +--- +id: TYPESCRIPT-naming-files +trigger: "when creating a new file" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: https://github.com/TaiChi112/TYPESCRIPT +--- + +# TYPESCRIPT Naming Files + +## Action + +Use camelCase naming convention + +## Evidence + +- Analyzed file naming patterns in repository +- Dominant pattern: camelCase + +--- +id: TYPESCRIPT-import-relative +trigger: "when importing modules" +confidence: 0.75 +domain: code-style +source: repo-analysis +source_repo: https://github.com/TaiChi112/TYPESCRIPT +--- + +# TYPESCRIPT Import Relative + +## Action + +Use relative imports for project files + +## Evidence + +- Import analysis shows relative import pattern +- Example: import { x } from '../lib/x' + +--- +id: TYPESCRIPT-export-style +trigger: "when exporting from a module" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: https://github.com/TaiChi112/TYPESCRIPT +--- + +# TYPESCRIPT Export Style + +## Action + +Prefer named exports + +## Evidence + +- Export pattern analysis +- Dominant style: named + +--- +id: TYPESCRIPT-test-separate +trigger: "when writing tests" +confidence: 0.8 +domain: testing +source: repo-analysis +source_repo: https://github.com/TaiChi112/TYPESCRIPT +--- + +# TYPESCRIPT 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: TYPESCRIPT-workflow-dependency-upgrade-across-multiple-packages +trigger: "when doing dependency upgrade across multiple packages" +confidence: 0.6 +domain: workflow +source: repo-analysis +source_repo: https://github.com/TaiChi112/TYPESCRIPT +--- + +# TYPESCRIPT Workflow Dependency Upgrade Across Multiple Packages + +## Action + +Follow the dependency-upgrade-across-multiple-packages workflow: +1. Detect outdated dependencies in multiple project directories. +2. Update package.json with new dependency versions in each affected directory. +3. Update corresponding lock files (package-lock.json, pnpm-lock.yaml) in each directory. +4. Commit all changes together with a detailed changelog. + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~2x per month +- Files: **/package.json, **/package-lock.json, **/pnpm-lock.yaml + +--- +id: typescript-instinct-naming-files +trigger: "When creating or renaming a file" +confidence: 0.85 +domain: code-style +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Naming Files + +## Action + +Use camelCase for file names + +## Evidence + +- Pattern in codeStyle.namingConventions.files + +--- +id: typescript-instinct-naming-functions +trigger: "When defining a function" +confidence: 0.85 +domain: code-style +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Naming Functions + +## Action + +Use camelCase for function names + +## Evidence + +- Pattern in codeStyle.namingConventions.functions + +--- +id: typescript-instinct-naming-classes +trigger: "When defining a class" +confidence: 0.85 +domain: code-style +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Naming Classes + +## Action + +Use PascalCase for class names + +## Evidence + +- Pattern in codeStyle.namingConventions.classes + +--- +id: typescript-instinct-naming-constants +trigger: "When defining a constant" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Naming Constants + +## Action + +Use SCREAMING_SNAKE_CASE for constant names + +## Evidence + +- Pattern in codeStyle.namingConventions.constants + +--- +id: typescript-instinct-import-style +trigger: "When importing modules" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Import Style + +## Action + +Use relative import paths + +## Evidence + +- Pattern in codeStyle.importStyle + +--- +id: typescript-instinct-export-style +trigger: "When exporting modules or symbols" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Export Style + +## Action + +Use named exports + +## Evidence + +- Pattern in codeStyle.exportStyle + +--- +id: typescript-instinct-test-location +trigger: "When adding new tests" +confidence: 0.7 +domain: testing +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Test Location + +## Action + +Place test files in a separate directory from source code + +## Evidence + +- Pattern in architecture.folderStructure.testLocation + +--- +id: typescript-instinct-git-commit-format +trigger: "When making a git commit" +confidence: 0.9 +domain: git +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Git Commit Format + +## Action + +Use conventional commit format with type prefix (e.g., build: ...) + +## Evidence + +- Pattern in commits.type +- Example: build(deps): bump the npm_and_yarn group... + +--- +id: typescript-instinct-git-commit-prefix-build +trigger: "When committing dependency upgrades or build-related changes" +confidence: 0.9 +domain: git +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Git Commit Prefix Build + +## Action + +Prefix commit message with build: or build(deps): + +## Evidence + +- Pattern in commits.prefixes +- Example: build(deps): bump the npm_and_yarn group... + +--- +id: typescript-instinct-dependency-upgrade-workflow +trigger: "When a new version of a dependency is released and needs to be applied across many packages/repos" +confidence: 0.98 +domain: workflow +source: repo-analysis +source_repo: TaiChi112/TYPESCRIPT +--- + +# Typescript Instinct Dependency Upgrade Workflow + +## Action + +Run the dependency-upgrade-across-multiple-packages workflow: detect outdated dependencies, update package.json and lock files in each directory, and commit all changes together with a detailed changelog + +## Evidence + +- workflow: dependency-upgrade-across-multiple-packages +- commits with build(deps): prefix +- files: **/package.json, **/package-lock.json, **/pnpm-lock.yaml +