From 5f263809c5a0ab155c56345fb125a3ac020f7ea3 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:23 +0000 Subject: [PATCH 01/11] feat: add varsha_v1 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..2cf4a76 --- /dev/null +++ b/.claude/ecc-tools.json @@ -0,0 +1,227 @@ +{ + "version": "1.3", + "schemaVersion": "1.0", + "generatedBy": "ecc-tools", + "generatedAt": "2026-07-25T16:52:03.728Z", + "repo": "https://github.com/yethikrishna/varsha_v1", + "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/varsha_v1/SKILL.md", + ".agents/skills/varsha_v1/SKILL.md", + ".agents/skills/varsha_v1/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/varsha_v1-instincts.yaml" + ], + "packageFiles": { + "runtime-core": [ + ".claude/skills/varsha_v1/SKILL.md", + ".agents/skills/varsha_v1/SKILL.md", + ".agents/skills/varsha_v1/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/varsha_v1-instincts.yaml" + ] + }, + "moduleFiles": { + "runtime-core": [ + ".claude/skills/varsha_v1/SKILL.md", + ".agents/skills/varsha_v1/SKILL.md", + ".agents/skills/varsha_v1/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/varsha_v1-instincts.yaml" + ] + }, + "files": [ + { + "moduleId": "runtime-core", + "path": ".claude/skills/varsha_v1/SKILL.md", + "description": "Repository-specific Claude Code skill generated from git history." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/varsha_v1/SKILL.md", + "description": "Codex-facing copy of the generated repository skill." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/varsha_v1/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/varsha_v1-instincts.yaml", + "description": "Continuous-learning instincts derived from repository patterns." + } + ], + "workflows": [], + "adapters": { + "claudeCode": { + "skillPath": ".claude/skills/varsha_v1/SKILL.md", + "identityPath": ".claude/identity.json", + "commandPaths": [] + }, + "codex": { + "configPath": ".codex/config.toml", + "agentsGuidePath": ".codex/AGENTS.md", + "skillPath": ".agents/skills/varsha_v1/SKILL.md" + } + } +} \ No newline at end of file From fe372ee7f7d6075f616b8486057d1d6bd864d7f0 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:24 +0000 Subject: [PATCH 02/11] feat: add varsha_v1 ECC bundle (.claude/skills/varsha_v1/SKILL.md) --- .claude/skills/varsha_v1/SKILL.md | 92 +++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 .claude/skills/varsha_v1/SKILL.md diff --git a/.claude/skills/varsha_v1/SKILL.md b/.claude/skills/varsha_v1/SKILL.md new file mode 100644 index 0000000..292ce3c --- /dev/null +++ b/.claude/skills/varsha_v1/SKILL.md @@ -0,0 +1,92 @@ +```markdown +# varsha_v1 Development Patterns + +> Auto-generated skill from repository analysis + +## Overview +This skill provides guidance on the core development patterns and conventions used in the `varsha_v1` TypeScript codebase. It covers file organization, code style, commit practices, and testing patterns to ensure consistency and maintainability across the project. While no specific framework is detected, the repository follows clear conventions for code structure and version control. + +## Coding Conventions + +### File Naming +- Use **camelCase** for file names. + - Example: `userProfile.ts`, `dataService.ts` + +### Import Style +- Use **relative imports** for referencing modules within the project. + - Example: + ```typescript + import { fetchData } from './dataService'; + ``` + +### Export Style +- Use **named exports** for all modules. + - Example: + ```typescript + // In dataService.ts + export function fetchData() { /* ... */ } + + // In another file + import { fetchData } from './dataService'; + ``` + +### Commit Messages +- Follow **conventional commit** format. +- Use the `feat` prefix for new features. +- Keep commit messages concise (average ~38 characters). + - Example: `feat: add user authentication module` + +## Workflows + +### Feature Development +**Trigger:** When adding a new feature or module +**Command:** `/feature-development` + +1. Create a new TypeScript file using camelCase naming. +2. Implement the feature using named exports. +3. Import any dependencies using relative paths. +4. Write corresponding test files using the `*.test.*` pattern. +5. Commit changes with a conventional message, e.g., `feat: implement user login`. + +### Code Testing +**Trigger:** When verifying code functionality +**Command:** `/run-tests` + +1. Identify or create test files matching the `*.test.*` pattern. +2. Run the test suite using your preferred TypeScript-compatible test runner. +3. Review test results and address any failures. + +### Code Review & Refactoring +**Trigger:** Before merging or after feedback +**Command:** `/code-review` + +1. Check that all files follow camelCase naming. +2. Ensure all imports are relative and exports are named. +3. Confirm that commit messages use the `feat` prefix and are concise. +4. Run all tests to verify code integrity. + +## Testing Patterns + +- Test files follow the `*.test.*` naming convention (e.g., `userProfile.test.ts`). +- The specific testing framework is not detected; use a TypeScript-compatible runner (such as Jest or Mocha). +- Tests should cover all exported functions and modules. + + Example: + ```typescript + // userProfile.test.ts + import { getUserProfile } from './userProfile'; + + describe('getUserProfile', () => { + it('should return user data for valid ID', () => { + // test implementation + }); + }); + ``` + +## Commands +| Command | Purpose | +|----------------------|-------------------------------------------| +| /feature-development | Start a new feature using project patterns| +| /run-tests | Run all test files in the codebase | +| /code-review | Review code for style and convention | +``` From 218a5959caa260248700ee3a046e8e92a24f64b2 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:25 +0000 Subject: [PATCH 03/11] feat: add varsha_v1 ECC bundle (.agents/skills/varsha_v1/SKILL.md) --- .agents/skills/varsha_v1/SKILL.md | 92 +++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 .agents/skills/varsha_v1/SKILL.md diff --git a/.agents/skills/varsha_v1/SKILL.md b/.agents/skills/varsha_v1/SKILL.md new file mode 100644 index 0000000..292ce3c --- /dev/null +++ b/.agents/skills/varsha_v1/SKILL.md @@ -0,0 +1,92 @@ +```markdown +# varsha_v1 Development Patterns + +> Auto-generated skill from repository analysis + +## Overview +This skill provides guidance on the core development patterns and conventions used in the `varsha_v1` TypeScript codebase. It covers file organization, code style, commit practices, and testing patterns to ensure consistency and maintainability across the project. While no specific framework is detected, the repository follows clear conventions for code structure and version control. + +## Coding Conventions + +### File Naming +- Use **camelCase** for file names. + - Example: `userProfile.ts`, `dataService.ts` + +### Import Style +- Use **relative imports** for referencing modules within the project. + - Example: + ```typescript + import { fetchData } from './dataService'; + ``` + +### Export Style +- Use **named exports** for all modules. + - Example: + ```typescript + // In dataService.ts + export function fetchData() { /* ... */ } + + // In another file + import { fetchData } from './dataService'; + ``` + +### Commit Messages +- Follow **conventional commit** format. +- Use the `feat` prefix for new features. +- Keep commit messages concise (average ~38 characters). + - Example: `feat: add user authentication module` + +## Workflows + +### Feature Development +**Trigger:** When adding a new feature or module +**Command:** `/feature-development` + +1. Create a new TypeScript file using camelCase naming. +2. Implement the feature using named exports. +3. Import any dependencies using relative paths. +4. Write corresponding test files using the `*.test.*` pattern. +5. Commit changes with a conventional message, e.g., `feat: implement user login`. + +### Code Testing +**Trigger:** When verifying code functionality +**Command:** `/run-tests` + +1. Identify or create test files matching the `*.test.*` pattern. +2. Run the test suite using your preferred TypeScript-compatible test runner. +3. Review test results and address any failures. + +### Code Review & Refactoring +**Trigger:** Before merging or after feedback +**Command:** `/code-review` + +1. Check that all files follow camelCase naming. +2. Ensure all imports are relative and exports are named. +3. Confirm that commit messages use the `feat` prefix and are concise. +4. Run all tests to verify code integrity. + +## Testing Patterns + +- Test files follow the `*.test.*` naming convention (e.g., `userProfile.test.ts`). +- The specific testing framework is not detected; use a TypeScript-compatible runner (such as Jest or Mocha). +- Tests should cover all exported functions and modules. + + Example: + ```typescript + // userProfile.test.ts + import { getUserProfile } from './userProfile'; + + describe('getUserProfile', () => { + it('should return user data for valid ID', () => { + // test implementation + }); + }); + ``` + +## Commands +| Command | Purpose | +|----------------------|-------------------------------------------| +| /feature-development | Start a new feature using project patterns| +| /run-tests | Run all test files in the codebase | +| /code-review | Review code for style and convention | +``` From ee971a5e72f7c189417e55b8feeab9c6af613752 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:26 +0000 Subject: [PATCH 04/11] feat: add varsha_v1 ECC bundle (.agents/skills/varsha_v1/agents/openai.yaml) --- .agents/skills/varsha_v1/agents/openai.yaml | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 .agents/skills/varsha_v1/agents/openai.yaml diff --git a/.agents/skills/varsha_v1/agents/openai.yaml b/.agents/skills/varsha_v1/agents/openai.yaml new file mode 100644 index 0000000..46ff60f --- /dev/null +++ b/.agents/skills/varsha_v1/agents/openai.yaml @@ -0,0 +1,6 @@ +interface: + display_name: "Varsha V1" + short_description: "Repo-specific patterns and workflows for varsha_v1" + default_prompt: "Use the varsha_v1 repo skill to follow existing architecture, testing, and workflow conventions." +policy: + allow_implicit_invocation: true \ No newline at end of file From d09b996223e427d5f4a5d81a8ab337bd6aa13727 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:27 +0000 Subject: [PATCH 05/11] feat: add varsha_v1 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..0fb3705 --- /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-07-25T16:52:17.406Z" +} \ No newline at end of file From 36872771bc7edea0af5a1590054b5ce48b49f84d Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:28 +0000 Subject: [PATCH 06/11] feat: add varsha_v1 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 f8258ca42ee75a2dc8b23979e869e6c88eb8126c Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:29 +0000 Subject: [PATCH 07/11] feat: add varsha_v1 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..1805650 --- /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/varsha_v1/SKILL.md` +- Claude-facing companion skill: `.claude/skills/varsha_v1/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 920b2b00c8fca2d0529c1fb297269ec538e1b2c0 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:30 +0000 Subject: [PATCH 08/11] feat: add varsha_v1 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 4d1988c5968bd6fe254d36452c4f78cc6379ce56 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:31 +0000 Subject: [PATCH 09/11] feat: add varsha_v1 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 de4aacb5e391d6bb735fca15b3a4e706dda5cbd9 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:32 +0000 Subject: [PATCH 10/11] feat: add varsha_v1 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 4ee3d153b3a495cdeb0e5e014880ed9149205f7b Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 16:52:33 +0000 Subject: [PATCH 11/11] feat: add varsha_v1 ECC bundle (.claude/homunculus/instincts/inherited/varsha_v1-instincts.yaml) --- .../inherited/varsha_v1-instincts.yaml | 357 ++++++++++++++++++ 1 file changed, 357 insertions(+) create mode 100644 .claude/homunculus/instincts/inherited/varsha_v1-instincts.yaml diff --git a/.claude/homunculus/instincts/inherited/varsha_v1-instincts.yaml b/.claude/homunculus/instincts/inherited/varsha_v1-instincts.yaml new file mode 100644 index 0000000..f676e3b --- /dev/null +++ b/.claude/homunculus/instincts/inherited/varsha_v1-instincts.yaml @@ -0,0 +1,357 @@ +# Instincts generated from https://github.com/yethikrishna/varsha_v1 +# Generated: 2026-07-25T16:52:17.406Z +# 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: varsha_v1-commit-conventional +trigger: "when writing a commit message" +confidence: 0.85 +domain: git +source: repo-analysis +source_repo: https://github.com/yethikrishna/varsha_v1 +--- + +# Varsha_v1 Commit Conventional + +## Action + +Use conventional commit format with prefixes: feat + +## Evidence + +- 1 commits analyzed +- Detected conventional commit pattern +- Examples: feat: Use Plugin: Trae Remote Official + +--- +id: varsha_v1-commit-length +trigger: "when writing a commit message" +confidence: 0.6 +domain: git +source: repo-analysis +source_repo: https://github.com/yethikrishna/varsha_v1 +--- + +# Varsha_v1 Commit Length + +## Action + +Keep commit messages concise (~38 characters) + +## Evidence + +- Average commit message length: 38 chars +- Based on 1 commits + +--- +id: varsha_v1-naming-files +trigger: "when creating a new file" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: https://github.com/yethikrishna/varsha_v1 +--- + +# Varsha_v1 Naming Files + +## Action + +Use camelCase naming convention + +## Evidence + +- Analyzed file naming patterns in repository +- Dominant pattern: camelCase + +--- +id: varsha_v1-import-relative +trigger: "when importing modules" +confidence: 0.75 +domain: code-style +source: repo-analysis +source_repo: https://github.com/yethikrishna/varsha_v1 +--- + +# Varsha_v1 Import Relative + +## Action + +Use relative imports for project files + +## Evidence + +- Import analysis shows relative import pattern +- Example: import { x } from '../lib/x' + +--- +id: varsha_v1-export-style +trigger: "when exporting from a module" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: https://github.com/yethikrishna/varsha_v1 +--- + +# Varsha_v1 Export Style + +## Action + +Prefer named exports + +## Evidence + +- Export pattern analysis +- Dominant style: named + +--- +id: varsha_v1-arch-type-based +trigger: "when adding new code" +confidence: 0.8 +domain: architecture +source: repo-analysis +source_repo: https://github.com/yethikrishna/varsha_v1 +--- + +# Varsha_v1 Arch Type Based + +## Action + +Place code in the appropriate type folder (components/, services/, utils/, etc.) + +## Evidence + +- Type-based module organization detected +- Folders: + +--- +id: varsha_v1-instinct-camelcase-files +trigger: "When creating a new file" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Camelcase Files + +## Action + +Name the file using camelCase + +## Evidence + +- Pattern in namingConventions.files + +--- +id: varsha_v1-instinct-camelcase-functions +trigger: "When defining a function" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Camelcase Functions + +## Action + +Name the function using camelCase + +## Evidence + +- Pattern in namingConventions.functions + +--- +id: varsha_v1-instinct-pascalcase-classes +trigger: "When defining a class" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Pascalcase Classes + +## Action + +Name the class using PascalCase + +## Evidence + +- Pattern in namingConventions.classes + +--- +id: varsha_v1-instinct-screaming-constants +trigger: "When declaring a constant" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Screaming Constants + +## Action + +Name the constant using SCREAMING_SNAKE_CASE + +## Evidence + +- Pattern in namingConventions.constants + +--- +id: varsha_v1-instinct-relative-imports +trigger: "When importing modules" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Relative Imports + +## Action + +Use relative import paths + +## Evidence + +- Pattern in importStyle + +--- +id: varsha_v1-instinct-named-exports +trigger: "When exporting from a module" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Named Exports + +## Action + +Use named exports + +## Evidence + +- Pattern in exportStyle + +--- +id: varsha_v1-instinct-try-catch-errors +trigger: "When handling errors in code" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Try Catch Errors + +## Action + +Use try-catch blocks for error handling + +## Evidence + +- Pattern in errorHandling.style + +--- +id: varsha_v1-instinct-conventional-commits-feat +trigger: "When writing a commit message for a new feature" +confidence: 0.9 +domain: git +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Conventional Commits Feat + +## Action + +Prefix the commit message with 'feat:' + +## Evidence + +- Seen in commit 'feat: Use Plugin: Trae Remote Official' +- Pattern in commits.prefixes + +--- +id: varsha_v1-instinct-commit-length +trigger: "When writing a commit message" +confidence: 0.7 +domain: git +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Commit Length + +## Action + +Keep the commit message concise (around 38 characters on average) + +## Evidence + +- Pattern in commits.averageLength + +--- +id: varsha_v1-instinct-single-package-structure +trigger: "When adding new modules or folders" +confidence: 0.8 +domain: architecture +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Single Package Structure + +## Action + +Place them within the single-package structure (e.g., under 'app') + +## Evidence + +- Pattern in folderStructure.type +- Pattern in folderStructure.commonFolders + +--- +id: varsha_v1-instinct-type-based-organization +trigger: "When organizing modules" +confidence: 0.8 +domain: architecture +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Type Based Organization + +## Action + +Group modules by type + +## Evidence + +- Pattern in moduleOrganization + +--- +id: varsha_v1-instinct-mixed-test-location +trigger: "When adding or locating tests" +confidence: 0.6 +domain: testing +source: repo-analysis +source_repo: yethikrishna/varsha_v1 +--- + +# Varsha_v1 Instinct Mixed Test Location + +## Action + +Place tests in mixed locations (not strictly separated from source) + +## Evidence + +- Pattern in folderStructure.testLocation +