Skip to content
Closed
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
121 changes: 121 additions & 0 deletions .agents/skills/dev-tools/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
---
name: dev-tools-conventions
description: Development conventions and patterns for dev-tools. TypeScript project with freeform commits.
---

# Dev Tools Conventions

> Generated from [php-fast-forward/dev-tools](https://github.com/php-fast-forward/dev-tools) on 2026-08-04

## Overview

This skill teaches Claude the development patterns and conventions used in dev-tools.

## Tech Stack

- **Primary Language**: TypeScript
- **Architecture**: hybrid module organization
- **Test Location**: separate

## When to Use This Skill

Activate this skill when:
- Making changes to this repository
- Adding new features following established patterns
- Writing tests that match project conventions
- Creating commits with proper message format

## Commit Conventions

Follow these commit message conventions based on 1 analyzed commits.

### Commit Style: Free-form Messages

### Message Guidelines

- Average message length: ~55 characters
- Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature")


*Commit message example*

```text
GitHub Actions(deps): Bump actions/checkout from 6 to 7
```

## Architecture

### Project Structure: Single Package

This project uses **hybrid** module organization.

### Configuration Files

- `.github/workflows/auto-assign.yml`
- `.github/workflows/auto-resolve-conflicts.yml`
- `.github/workflows/changelog.yml`
- `.github/workflows/label-sync.yml`
- `.github/workflows/reports.yml`
- `.github/workflows/retry-transient-failures.yml`
- `.github/workflows/review.yml`
- `.github/workflows/tests.yml`
- `.github/workflows/wiki-maintenance.yml`
- `.github/workflows/wiki-preview.yml`

### Guidelines

- This project uses a hybrid organization
- Follow existing patterns when adding new code

## Code Style

### Language: TypeScript

### Naming Conventions

| Element | Convention |
|---------|------------|
| Files | kebab-case |
| Functions | camelCase |
| Classes | PascalCase |
| Constants | SCREAMING_SNAKE_CASE |

### Import Style: Relative Imports

### Export Style: Named Exports


*Preferred import style*

```typescript
// Use relative imports
import { Button } from '../components/Button'
import { useAuth } from './hooks/useAuth'
```

*Preferred export style*

```typescript
// Use named exports
export function calculateTotal() { ... }
export const TAX_RATE = 0.1
export interface Order { ... }
```

## Best Practices

Based on analysis of the codebase, follow these practices:

### Do

- Use kebab-case for file names
- Prefer named exports

### Don't

- Don't deviate from established patterns without discussion

---

*This skill was auto-generated by [ECC Tools](https://ecc.tools). Review and customize as needed for your team.*
6 changes: 6 additions & 0 deletions .agents/skills/dev-tools/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "Dev Tools"
short_description: "Repo-specific patterns and workflows for dev-tools"
default_prompt: "Use the dev-tools repo skill to follow existing architecture, testing, and workflow conventions."
policy:
allow_implicit_invocation: true
251 changes: 251 additions & 0 deletions .claude/ecc-tools.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,251 @@
{
"version": "1.3",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-08-04T14:33:37.409Z",
"repo": "https://github.com/php-fast-forward/dev-tools",
"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": "security",
"recommended": "security",
"effective": "developer",
"requestedAlias": "security",
"recommendedAlias": "security",
"effectiveAlias": "developer"
},
"requestedProfile": "security",
"profile": "developer",
"recommendedProfile": "security",
"effectiveProfile": "developer",
"tier": "free",
"requestedComponents": [
"repo-baseline",
"workflow-automation",
"security-audits"
],
"selectedComponents": [
"repo-baseline",
"workflow-automation"
],
"requestedAddComponents": [],
"requestedRemoveComponents": [],
"blockedRemovalComponents": [],
"tierFilteredComponents": [
"security-audits"
],
"requestedRootPackages": [
"runtime-core",
"workflow-pack",
"agentshield-pack"
],
"selectedRootPackages": [
"runtime-core",
"workflow-pack"
],
"requestedPackages": [
"runtime-core",
"workflow-pack",
"agentshield-pack"
],
"requestedAddPackages": [],
"requestedRemovePackages": [],
"selectedPackages": [
"runtime-core",
"workflow-pack"
],
"packages": [
"runtime-core",
"workflow-pack"
],
"blockedRemovalPackages": [],
"tierFilteredRootPackages": [
"agentshield-pack"
],
"tierFilteredPackages": [
"agentshield-pack"
],
"conflictingPackages": [],
"dependencyGraph": {
"runtime-core": [],
"workflow-pack": [
"runtime-core"
]
},
"resolutionOrder": [
"runtime-core",
"workflow-pack"
],
"requestedModules": [
"runtime-core",
"workflow-pack",
"agentshield-pack"
],
"selectedModules": [
"runtime-core",
"workflow-pack"
],
"modules": [
"runtime-core",
"workflow-pack"
],
"managedFiles": [
".claude/skills/dev-tools/SKILL.md",
".agents/skills/dev-tools/SKILL.md",
".agents/skills/dev-tools/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/dev-tools-instincts.yaml"
],
"packageFiles": {
"runtime-core": [
".claude/skills/dev-tools/SKILL.md",
".agents/skills/dev-tools/SKILL.md",
".agents/skills/dev-tools/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/dev-tools-instincts.yaml"
]
},
"moduleFiles": {
"runtime-core": [
".claude/skills/dev-tools/SKILL.md",
".agents/skills/dev-tools/SKILL.md",
".agents/skills/dev-tools/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/dev-tools-instincts.yaml"
]
},
"files": [
{
"moduleId": "runtime-core",
"path": ".claude/skills/dev-tools/SKILL.md",
"description": "Repository-specific Claude Code skill generated from git history."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/dev-tools/SKILL.md",
"description": "Codex-facing copy of the generated repository skill."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/dev-tools/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/dev-tools-instincts.yaml",
"description": "Continuous-learning instincts derived from repository patterns."
}
],
"workflows": [],
"adapters": {
"claudeCode": {
"skillPath": ".claude/skills/dev-tools/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": []
},
"codex": {
"configPath": ".codex/config.toml",
"agentsGuidePath": ".codex/AGENTS.md",
"skillPath": ".agents/skills/dev-tools/SKILL.md"
}
}
}
Loading
Loading