Agentify

Auto-detect your project's tech stack and generate Claude Code configuration files.

Agentify scans your project, detects the tech stack, and writes .claude/CLAUDE.md and .claude/skills/{stack}/SKILL.md so Claude has context about your architecture, best practices, and common commands. If CLAUDE.md already exists, it appends the skills section rather than overwriting.

Usage

npx @coceresroman/agentify init

| Flag | Description | Default | |------|-------------|---------| | --yes, -y | Skip confirmation prompts | false | | --no-interaction | Non-interactive mode (CI/CD) | false | | --output <path>, -o | Output directory | .claude | | --debug, -d | Verbose logging | false |

Supported stacks

| Ecosystem | Stacks | |-----------|--------| | Frontend | React, Vue, Angular, Next.js | | Node.js | NestJS, Express | | Python | Django, Flask, FastAPI | | Java | Spring Boot | | Infrastructure | Docker | | CI/CD | GitHub Actions |

Architecture

agentify/
├── src/
│   ├── cli.ts                   # CLI entry point
│   ├── commands/init.ts         # Init command
│   ├── detectors/               # Per-ecosystem detectors
│   │   ├── node.detector.ts
│   │   ├── python.detector.ts
│   │   ├── java.detector.ts
│   │   ├── go.detector.ts
│   │   ├── docker.detector.ts
│   │   ├── ci.detector.ts
│   │   └── index.ts             # Detector registry
│   ├── templates/
│   │   ├── claude-md/           # CLAUDE.md templates
│   │   └── skills/              # Per-stack SKILL.md templates
│   ├── analyzer.ts              # Confidence filtering (≥70% threshold)
│   ├── generator.ts             # Template rendering
│   ├── writer.ts                # File writing / appending
│   ├── prompts.ts               # Interactive prompts
│   └── utils/
├── tests/
│   ├── unit/
│   └── integration/
└── bin/

Detection pipeline: detectors → analyzer (confidence filter) → generator (Handlebars templates) → writer (fs output).

Contributing

Adding a detector

1. Create src/detectors/my-framework.detector.ts:

import { DetectorFunction } from '../types/index.js';

export const detect: DetectorFunction = async (projectRoot) => {
  const hasIndicator = await checkForIndicator(projectRoot);
  if (!hasIndicator) return null;

  return {
    stack: 'my-framework',
    confidence: 0.8,
    evidence: ['Found indicator X', 'Found indicator Y'],
    metadata: { version: '1.0.0' }
  };
};

2. Register in src/detectors/index.ts
3. Add a skill template at src/templates/skills/my-framework/SKILL.md.hbs
4. Add tests in tests/unit/detectors/my-framework.detector.test.ts

Development setup

git clone https://github.com/coceresroman/agentify.git
cd agentify
npm install
npm run build
npm test

Guidelines

• Write tests for every new detector
• Keep confidence scoring consistent with existing detectors
• Skill templates should include best practices, common commands, and patterns

License

GPL-2.0