CF-Progress

Outil de suivi de progression pour projets Claude-Flow avec double persistance :

1. Mémoire Claude-Flow (.swarm/memory.db) - Recherche sémantique
2. Document lisible (.claude/PROJECT_PROGRESS.md) - Historique humain

Installation

# Installation globale
npm install -g cf-progress

# Ou installation locale dans un projet
npm install cf-progress

Utilisation

Initialiser un projet

cd mon-projet
cf-progress init "Mon Projet" "mon_namespace"

# Ou avec le nom du dossier comme défaut
cf-progress init

Sauvegarder une phase

Après chaque phase SPARC :

cf-progress save specification "API REST définie avec 5 endpoints" "JWT, PostgreSQL"
cf-progress save architecture "Microservices avec Docker" "Redis, RabbitMQ"
cf-progress save implementation "Backend terminé, 45 tests"
cf-progress save testing "Couverture 92%, tests E2E passent"
cf-progress save completion "Déployé en production" "CI/CD GitHub Actions"

Voir la progression

cf-progress show

Lister les phases mémorisées

cf-progress list

Phases SPARC suggérées

| Phase | Description | |-------|-------------| | specification | Analyse des besoins | | pseudocode | Algorithmes en pseudo-code | | architecture | Design système | | implementation | Développement | | testing | Tests et validation | | completion | Finalisation |

Structure créée

mon-projet/
├── .claude/
│   ├── PROJECT_PROGRESS.md    ← Document de suivi lisible
│   └── progress-config.json   ← Configuration du projet
└── .swarm/
    └── memory.db              ← Mémoire Claude-Flow (si disponible)

Récupération du contexte

# Voir le document
cf-progress show

# Rechercher dans la mémoire Claude-Flow
npx claude-flow@alpha memory query "architecture" --namespace mon_projet

# Lister toutes les entrées
npx claude-flow@alpha memory list --namespace mon_projet

Exemple de workflow complet

# 1. Créer et initialiser le projet
mkdir mon-api && cd mon-api
git init
cf-progress init "Mon API REST" "api_v1"

# 2. Phase Spécification
# ... travailler sur les specs ...
cf-progress save specification "5 endpoints définis: users, auth, products" "REST, JWT RS256"

# 3. Phase Architecture
# ... designer l'architecture ...
cf-progress save architecture "3-tiers: API Gateway, Services, DB" "PostgreSQL, Redis, Docker"

# 4. Phase Implémentation
# ... coder ...
cf-progress save implementation "Backend complet, 45 tests unitaires" "Express, Prisma"

# 5. Phase Tests
# ... tester ...
cf-progress save testing "92% coverage, tests E2E OK" "Jest, Supertest"

# 6. Phase Completion
# ... déployer ...
cf-progress save completion "Déployé sur AWS ECS" "Terraform, GitHub Actions"

# 7. Voir le résultat
cf-progress show

Licence

MIT