Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
90 changes: 90 additions & 0 deletions .agents/skills/growthOS/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
```markdown
# growthOS Development Patterns

> Auto-generated skill from repository analysis

## Overview
This skill teaches the core development patterns and conventions used in the `growthOS` TypeScript codebase. It covers file organization, code style, commit message standards, and testing patterns to help contributors maintain consistency and quality.

## Coding Conventions

### File Naming
- **Pattern:** PascalCase
- **Example:**
`UserProfile.ts`
`OrderManager.ts`

### Import Style
- **Pattern:** Relative imports
- **Example:**
```typescript
import { UserService } from '../services/UserService';
```

### Export Style
- **Pattern:** Named exports
- **Example:**
```typescript
export function calculateGrowth() { ... }
export const GROWTH_RATE = 1.05;
```

### Commit Messages
- **Pattern:** Conventional Commits
- **Prefix Used:** `feat`
- **Average Length:** ~44 characters
- **Example:**
```
feat: add user onboarding flow
```

## Workflows

### Creating a New Feature
**Trigger:** When adding a new functionality or module
**Command:** `/new-feature`

1. Create a new file using PascalCase (e.g., `NewFeature.ts`).
2. Use relative imports to include dependencies.
3. Export your functions or constants using named exports.
4. Write corresponding tests in a file named `NewFeature.test.ts`.
5. Commit your changes with a message starting with `feat:` and a concise description.

### Writing Tests
**Trigger:** When verifying the correctness of a module
**Command:** `/write-test`

1. Create a test file alongside your module, following the pattern `*.test.ts` (e.g., `UserProfile.test.ts`).
2. Implement test cases for all exported functions and constants.
3. Run your tests using the project's test runner (framework is currently unknown).

### Making a Commit
**Trigger:** When saving changes to version control
**Command:** `/commit`

1. Stage your changes.
2. Write a commit message starting with `feat:` followed by a brief summary (max ~44 chars).
3. Push your commit to the repository.

## Testing Patterns

- **File Pattern:** All test files follow the `*.test.ts` naming convention.
- **Location:** Test files are placed alongside the modules they test.
- **Framework:** Not explicitly detected; use the project's preferred test runner.
- **Example:**
```typescript
// UserProfile.test.ts
import { getUserName } from './UserProfile';

test('should return correct user name', () => {
expect(getUserName({ name: 'Alice' })).toBe('Alice');
});
```

## Commands
| Command | Purpose |
|----------------|----------------------------------------------------|
| /new-feature | Scaffold a new feature/module with conventions |
| /write-test | Create a test file for a module |
| /commit | Make a conventional commit with proper formatting |
```
6 changes: 6 additions & 0 deletions .agents/skills/growthOS/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "GrowthOS"
short_description: "Repo-specific patterns and workflows for growthOS"
default_prompt: "Use the growthOS repo skill to follow existing architecture, testing, and workflow conventions."
policy:
allow_implicit_invocation: true
227 changes: 227 additions & 0 deletions .claude/ecc-tools.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,227 @@
{
"version": "1.3",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-07-06T16:38:47.245Z",
"repo": "https://github.com/melgarafael/growthOS",
"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/growthOS/SKILL.md",
".agents/skills/growthOS/SKILL.md",
".agents/skills/growthOS/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/growthOS-instincts.yaml"
],
"packageFiles": {
"runtime-core": [
".claude/skills/growthOS/SKILL.md",
".agents/skills/growthOS/SKILL.md",
".agents/skills/growthOS/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/growthOS-instincts.yaml"
]
},
"moduleFiles": {
"runtime-core": [
".claude/skills/growthOS/SKILL.md",
".agents/skills/growthOS/SKILL.md",
".agents/skills/growthOS/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/growthOS-instincts.yaml"
]
},
"files": [
{
"moduleId": "runtime-core",
"path": ".claude/skills/growthOS/SKILL.md",
"description": "Repository-specific Claude Code skill generated from git history."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/growthOS/SKILL.md",
"description": "Codex-facing copy of the generated repository skill."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/growthOS/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/growthOS-instincts.yaml",
"description": "Continuous-learning instincts derived from repository patterns."
}
],
"workflows": [],
"adapters": {
"claudeCode": {
"skillPath": ".claude/skills/growthOS/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": []
},
"codex": {
"configPath": ".codex/config.toml",
"agentsGuidePath": ".codex/AGENTS.md",
"skillPath": ".agents/skills/growthOS/SKILL.md"
}
}
}
Loading