aid

Files (3)

• SKILL.md
• capabilities-and-examples.md · references/
• integration-and-technical.md · references/

SKILL.md (first lines)

# AI-Distiller (aid) - Code Analysis Skill

## Purpose

Interface to AI-Distiller (aid.exe) for intelligent code distillation — extracting essential structure while preserving semantic information for LLM consumption. Provides comprehensive code analysis including refactoring, security, performance, architecture, and documentation.

## Project Context

### Constitution / Constraints
- **Solo-dev constraints apply** (CLAUDE.md)
- **No enterprise patterns**: Recommend solo-appropriate solutions, not complex abstractions
- **Truthfulness required**: Report findings accurately, don't sugarcoat technical debt
- **Evidence-based analysis**: Specific file locations and line numbers, not speculation
- **READ-BEFORE-WRITE**: Always explore existing code before recommending changes

### Technical Context
- **Python wrapper**: `$__CSF_ROOT/src\commands\aid\aid.py`
- **aid.exe location**: `$__CSF_ROOT/tools\ai-distiller-optimized\aid.exe`
- **AI-Distiller Version**: v1.3.1 (built 2025-06-21)
- **Output location**: `P://.aid/[ANALYSIS-TYPE].[timestamp].[filename].md`
- **Supported languages**: Python, TypeScript, JavaScript, Go, Rust, Java, C#, Kotlin, C++, PHP, Ruby, Swift
- **Compression ratio**: 60-90% size reduction while preserving semantic information

### Architecture Alignment
- Uses structured subcommands (refactor, arch, security, perf, best, bugs, docs, diagrams, flow, multi, git)
- Integrates with CSF NIP ecosystem (aid-status, aid-security, aid-performance, aid-diagrams)
- Results saved with timestamps for traceability

## Your Workflow

1. **Identify analysis type** — Determine which subcommand fits user need (refactor, security, perf, arch, etc.)
2. **Set visibility level** — Use --private/--protected/--internal as appropriate
3. **Choose output format** --format md|text|jsonl|xml, and optionally --stdout
4. **Execute aid.exe** — Run via wrapper with appropriate arguments
5. **Locate results** — Check `P://.aid/` for timestamped output files
6. **Present findings** — Summarize key insights with file:line citations

## Validation Rules

- **Before refactoring recommendations**: Verify analysis was actually run on current code
- **Before security claims**: Ensure --private flag was used if needed
- **Before architectural changes**: Verify findings with actual file reads
- **Filter all recommendations**: Apply SoloDevConstitutionalFilter (no enterprise bloat)
- **Report accurately**: Don't sugarcoat technical debt or severity

### Prohibited Actions
- Sugarcoating technical debt severity
- Recommending patterns without proven need or director approval
- Ignoring security vulnerabilities
- Making claims without reading actual files first

## When to Use

Use `/aid` when you need to:
- Analyze code for refactoring opportunities (technical debt, SOLID violations)
- Generate architecture diagrams and visualizations
- Perform security audits (OWASP Top 10 focus)
- Identify performance bottlenecks
- Create comprehensive documentation
- Generate structured analysis workflows
- Analyze git history with AI insights

## Quick Reference

| Shortcut | Purpose | Example |
|----------|---------|---------|
| `refactor` | Refactoring analysis | `/aid refactor src/main.py` |
| `arch` | Codebase architecture | `/aid arch . --format md` |
| `security` | Security audit (OWASP) | `/aid security . --private` |
| `perf` | Performance analysis | `/aid perf src/` |
| `best` | Best practices review | `/aid best core.py` |
| `bugs` | Bug hunting | `/aid bugs .` |
| `docs` | Documentation | `/aid docs file.py` |
| `diagrams` | Mermaid diagrams (10x) | `/aid diagrams src/` |
| `flow` | Analysis workflow | `/aid flow . --stdout` |
| `multi` | Multi-file docs | `/aid multi src/` |
| `git` | Git history | `/aid git 50` |

## Advanced Options

| Option | Purpose |
|--------|---------|
| `--format md|text|jsonl|xml` | Output format |
| `--stdout` | Print to stdout (in addition to file) |
| `--private/--protected/--internal` | Visibility control |
| `--implementation` | Include function bodies |
| `--include "*.py,*.ts"` | File patterns to include |
| `--exclude "*test*"` | File patterns to exclude |

## Output Location

Results saved to `P://.aid/[ANALYSIS-TYPE].[timestamp].[filename].md`

## Reference Files

| File | Contents |
|------|----------|
| `references/capabilities-and-examples.md` | Key capabilities (refactoring, security, perf, arch, docs), git mode, use-case examples |
| `references/integration-and-technical.md` | CSF NIP integration, technical details (version, languages, compression), constitutional notes |

From EndUser123/search-research, MIT.

More from EndUser123/search-research