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
88 changes: 88 additions & 0 deletions .agents/skills/Behavioral_RL/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
```markdown
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: Remove the outer ```markdown and ``` code fences. Since the file is already a .md file, the content should be raw markdown — wrapping it in a code block causes headings, tables, and lists to render as literal code text rather than formatted instructions, which defeats the purpose of the skill file.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At .agents/skills/Behavioral_RL/SKILL.md, line 1:

<comment>Remove the outer ` ```markdown` and ` ``` ` code fences. Since the file is already a `.md` file, the content should be raw markdown — wrapping it in a code block causes headings, tables, and lists to render as literal code text rather than formatted instructions, which defeats the purpose of the skill file.</comment>

<file context>
@@ -0,0 +1,88 @@
+```markdown
+# Behavioral_RL Development Patterns
+
</file context>

# Behavioral_RL Development Patterns

> Auto-generated skill from repository analysis

## Overview
This skill teaches the core development patterns and workflows used in the `Behavioral_RL` repository, a TypeScript codebase focused on behavioral reinforcement learning. It covers file organization, coding conventions, import/export styles, and automated workflows for dependency management. The guide also includes best practices for writing and running tests.

## Coding Conventions

**File Naming**
- Use camelCase for file names.
- Example: `behavioralAgent.ts`, `rewardFunction.ts`

**Import Style**
- Use relative imports for modules within the project.
- Example:
```typescript
import { computeReward } from './rewardFunction';
```

**Export Style**
- Use named exports for functions, classes, and constants.
- Example:
```typescript
// In rewardFunction.ts
export function computeReward(state: State): number { ... }
```

**Commit Messages**
- Freeform style, no strict prefixing.
- Average commit message length: ~55 characters.

## Workflows

### Bulk Dependency Update Across Experiment Directories
**Trigger:** When you need to update core Python dependencies for all experiment runs managed by wandb.
**Command:** `/bulk-update-dependencies`

1. Identify all wandb run directories under `wandb/*/files/`.
2. For each run directory, open the `requirements.txt` file.
3. Update the following dependencies to their new versions: `idna`, `mistune`, `ujson`, `urllib3`.
4. Save the updated `requirements.txt` in each directory.
5. Commit all updated `requirements.txt` files in a single commit.

**Example Directory Structure:**
```
wandb/
run1/
files/
requirements.txt
run2/
files/
requirements.txt
```

**Example Update in `requirements.txt`:**
```
idna==3.4
mistune==2.0.4
ujson==5.8.0
urllib3==2.0.2
```

## Testing Patterns

- Test files follow the pattern: `*.test.*`
- Example: `behavioralAgent.test.ts`
- The specific testing framework is not detected; check the project for further details.
- Place test files alongside or near the code they test.

**Example Test File:**
```typescript
// behavioralAgent.test.ts
import { computeReward } from './rewardFunction';

test('computeReward returns correct value', () => {
expect(computeReward({ score: 10 })).toBe(100);
});
```

## Commands

| Command | Purpose |
|---------------------------|-----------------------------------------------------------------|
| /bulk-update-dependencies | Update Python dependencies in all wandb experiment requirements. |

```
6 changes: 6 additions & 0 deletions .agents/skills/Behavioral_RL/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "Behavioral RL"
short_description: "Repo-specific patterns and workflows for Behavioral_RL"
default_prompt: "Use the Behavioral_RL 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-05-20T03:29:23.419Z",
"repo": "https://github.com/affaan-m/Behavioral_RL",
"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": "enterprise",
"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/Behavioral_RL/SKILL.md",
".agents/skills/Behavioral_RL/SKILL.md",
".agents/skills/Behavioral_RL/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/Behavioral_RL-instincts.yaml"
],
"packageFiles": {
"runtime-core": [
".claude/skills/Behavioral_RL/SKILL.md",
".agents/skills/Behavioral_RL/SKILL.md",
".agents/skills/Behavioral_RL/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/Behavioral_RL-instincts.yaml"
]
},
"moduleFiles": {
"runtime-core": [
".claude/skills/Behavioral_RL/SKILL.md",
".agents/skills/Behavioral_RL/SKILL.md",
".agents/skills/Behavioral_RL/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/Behavioral_RL-instincts.yaml"
]
},
"files": [
{
"moduleId": "runtime-core",
"path": ".claude/skills/Behavioral_RL/SKILL.md",
"description": "Repository-specific Claude Code skill generated from git history."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/Behavioral_RL/SKILL.md",
"description": "Codex-facing copy of the generated repository skill."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/Behavioral_RL/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/Behavioral_RL-instincts.yaml",
"description": "Continuous-learning instincts derived from repository patterns."
}
],
"workflows": [],
"adapters": {
"claudeCode": {
"skillPath": ".claude/skills/Behavioral_RL/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": []
},
"codex": {
"configPath": ".codex/config.toml",
"agentsGuidePath": ".codex/AGENTS.md",
"skillPath": ".agents/skills/Behavioral_RL/SKILL.md"
}
}
}
Loading