Skip to content

Commit 561c944

Browse files
wolfieschclaudehappy-otter
committed
docs(import): update Aider format documentation and fidelity matrix
- Aider improved from D (68%) → C (74%) with full daemon recovery - Updated structure example to include tool bullet lists - Added name inference section explaining "for the X project" pattern - Added Aider column to fidelity summary and field recovery tables - Updated key insights to reflect 7 formats now achieve full daemon recovery Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
1 parent d9d84b2 commit 561c944

1 file changed

Lines changed: 39 additions & 31 deletions

File tree

docs/IMPORT-FORMATS.md

Lines changed: 39 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -381,49 +381,56 @@ MCP tool names are parsed:
381381

382382
## Aider (CONVENTIONS.md)
383383

384-
**Fidelity: ~35%** | **Pattern: `CONVENTIONS.md`, `*.CONVENTIONS.md`**
384+
**Fidelity: ~70%** | **Quality Grade: C (74%)** | **Pattern: `CONVENTIONS.md`, `*.CONVENTIONS.md`**
385385

386-
Project conventions and style preferences.
386+
Project conventions and style preferences. Enhanced with daemon extraction from bullet lists.
387387

388388
### Structure
389389

390390
```markdown
391391
# Project Conventions
392392

393+
This document outlines conventions for the productivity assistant project.
394+
393395
## Code Style
394396

395397
- Use TypeScript strict mode
396398
- Prefer functional components
397-
- Use ESLint with recommended rules
398399

399-
## Architecture
400+
## Available Tools
400401

401-
- Follow hexagonal architecture
402-
- Keep business logic in services
403-
- Use dependency injection
402+
- gmail.inbox - List emails
403+
- gmail.send - Send email
404+
- calendar.list - List events
405+
- calendar.create - Create event
404406

405407
## Testing
406408

407409
- Write unit tests for all services
408-
- Use Jest for testing
409410
```
410411

411412
### What's Extracted
412413

413414
| Field | Source | Confidence |
414415
|-------|--------|------------|
415-
| name | Filename or "conventions" | Low |
416-
| description | First paragraph | Low |
416+
| name | "for the X project" pattern or filename | Medium |
417+
| description | First paragraph | Medium |
417418
| version | Default `1.0.0` | Low |
418-
| daemons | Pattern matching | Low |
419+
| daemons | Bullet list `daemon.method` patterns | High |
420+
| triggers | Auto-generated from daemon names | Low |
419421
| instructions | Full content | High |
420422

423+
### Name Inference
424+
425+
The parser extracts meaningful names from description text:
426+
- "for the productivity assistant project" → "Productivity Assistant"
427+
- Falls back to filename if no pattern found
428+
421429
### Limitations
422430

423-
- Conventions format is minimal
424-
- No tool/daemon definitions typically
425-
- Style preferences only
426-
- Best used as supplementary instructions
431+
- No version or author information
432+
- Triggers inferred from detected daemons
433+
- Works best with `daemon.method` bullet patterns
427434

428435
---
429436

@@ -480,22 +487,23 @@ importing to FGP skill.yaml, and measuring what data was preserved.
480487
| **Cursor** | 🟡 C (76%) | ~70% | ✅ Full | Project-level coding guidelines |
481488
| **Zed** | 🟡 C (75%) | ~70% | ✅ Full | Context rules with bullet lists |
482489
| **Codex** | 🟡 C (75%) | ~70% | ✅ Full | Tool-centric configurations |
490+
| **Aider** | 🟡 C (74%) | ~70% | ✅ Full | Project conventions with tool lists |
483491
| **MCP** | 🔴 F (28%) | ~25% | ❌ None | API/tool schema definitions |
484492

485493
### Field Recovery by Format
486494

487-
| Field | Gemini | Windsurf | Claude Code | Zed | Codex | Cursor | MCP |
488-
|-------|--------|----------|-------------|-----|-------|--------|-----|
489-
| **name** | ✅ High | ✅ High | ✅ High | ⚠️ Medium | ✅ High | ⚠️ Medium | ✅ High |
490-
| **version** | ✅ High | ✅ High | ✅ High | ❌ Default | ❌ Default | ❌ Default | ❌ Default |
491-
| **description** | ✅ High | ✅ High | ✅ High | ⚠️ Medium | ✅ High | ⚠️ Medium | ✅ High |
492-
| **author** | ✅ High | ✅ High | ⚠️ Partial | ❌ None | ❌ None | ❌ None | ❌ None |
493-
| **instructions** | ✅ High | ✅ High | ✅ High | ✅ High | ✅ High | ✅ High | ⚠️ Medium |
494-
| **daemons** | ✅ Full | ✅ Full | ⚠️ Medium (33%) | ✅ Full | ✅ Full | ✅ Full | ❌ None |
495-
| **triggers** | ✅ High | ✅ High | ⚠️ Medium | ⚠️ Low | ❌ None | ❌ None | ❌ None |
496-
| **workflows** | ❌ N/A | ❌ N/A | ❌ Lost | ❌ N/A | ❌ N/A | ❌ N/A | ❌ N/A |
497-
| **config** | ❌ N/A | ❌ N/A | ❌ Lost | ❌ N/A | ❌ N/A | ❌ N/A | ❌ N/A |
498-
| **auth** | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched |
495+
| Field | Gemini | Windsurf | Claude Code | Zed | Codex | Cursor | Aider | MCP |
496+
|-------|--------|----------|-------------|-----|-------|--------|-------|-----|
497+
| **name** | ✅ High | ✅ High | ✅ High | ⚠️ Medium | ✅ High | ⚠️ Medium | ⚠️ Medium | ✅ High |
498+
| **version** | ✅ High | ✅ High | ✅ High | ❌ Default | ❌ Default | ❌ Default | ❌ Default | ❌ Default |
499+
| **description** | ✅ High | ✅ High | ✅ High | ⚠️ Medium | ✅ High | ⚠️ Medium | ⚠️ Medium | ✅ High |
500+
| **author** | ✅ High | ✅ High | ⚠️ Partial | ❌ None | ❌ None | ❌ None | ❌ None | ❌ None |
501+
| **instructions** | ✅ High | ✅ High | ✅ High | ✅ High | ✅ High | ✅ High | ✅ High | ⚠️ Medium |
502+
| **daemons** | ✅ Full | ✅ Full | ⚠️ Medium (33%) | ✅ Full | ✅ Full | ✅ Full | ✅ Full | ❌ None |
503+
| **triggers** | ✅ High | ✅ High | ⚠️ Medium | ⚠️ Low | ❌ None | ❌ None | ⚠️ Low | ❌ None |
504+
| **workflows** | ❌ N/A | ❌ N/A | ❌ Lost | ❌ N/A | ❌ N/A | ❌ N/A | ❌ N/A | ❌ N/A |
505+
| **config** | ❌ N/A | ❌ N/A | ❌ Lost | ❌ N/A | ❌ N/A | ❌ N/A | ❌ N/A | ❌ N/A |
506+
| **auth** | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched | ⚠️ Enriched |
499507

500508
### Key Insights
501509

@@ -505,8 +513,8 @@ importing to FGP skill.yaml, and measuring what data was preserved.
505513
2. **Windsurf remains excellent** (87%) because its `capabilities` structure
506514
maps directly to FGP's daemon/method model, plus it has explicit triggers and author.
507515

508-
3. **Six formats now achieve full daemon recovery**: Gemini, Windsurf, Zed, Codex, and
509-
Cursor all use explicit or inferred `daemon.method` patterns.
516+
3. **Seven formats now achieve full daemon recovery**: Gemini, Windsurf, Zed, Codex,
517+
Cursor, and Aider all use explicit or inferred `daemon.method` patterns.
510518

511519
4. **Zed format improved significantly** (F→C) through markdown bullet list extraction
512520
and role name parsing from intro lines like "specialized in X".
@@ -521,8 +529,8 @@ importing to FGP skill.yaml, and measuring what data was preserved.
521529
7. **Registry enrichment helps all formats** by recovering auth requirements and
522530
method details when daemons are recognized in the FGP daemon registry.
523531

524-
8. **Aider format remains documentation-centric** - excellent for preserving
525-
instructions but lacks structural metadata.
532+
8. **Aider format now achieves full daemon recovery** (D→C, 74%) through shared
533+
bullet extraction and project name inference from description patterns.
526534

527535
9. **MCP format is API-focused** - preserves tool schemas but doesn't map
528536
naturally to FGP's daemon model.

0 commit comments

Comments
 (0)