Capturer session complète en markdown avec Friday

Contexte

Vous terminez une session Claude Code et voulez capturer le contexte projet complet en markdown (15K chars max) pour les sessions futures et générer un document de contexte optimisé pour Claude. Friday automatise cette capture.

Prérequis

Projet avec racine accessible
docs/ directory (créé par Friday si absent)
Accès Read sur le projet
Session en cours ou récente (dernier commit, historique Git)

Étapes

1. Génération du contexte LLM (15K chars max)

Invquez Friday en mode context :

/ulk:friday mode=context

ou simplement

Génère le contexte

Friday exécute Phase C1 (Exploration) et produit docs/context.md.

2. Lecture des sources principales

Friday lit automatiquement (si présentes) :

cat README.md             # Purpose, install, usage
cat CLAUDE.md             # Rules, conventions
cat package.json          # Stack, scripts
cat docs/spec.md          # Architecture
cat docs/todo.md          # Backlog
cat .claude/settings.json # MCP, commands

3. Extrait avec optimisation apfel (si disponible)

Si apfel est installé sur macOS 26+ :

apfel -q -f README.md "extract: purpose, install, usage. Max 5 lines."
apfel -q -f package.json "name, version, main scripts, dependencies. Max 5 lines."

Chaque extraction : ~100-200 chars (au lieu de lire le fichier entier = ~1-5K tokens économisés).

4. Assemblage du contexte.md

Résultat dans docs/context.md :

# Project Context — generated 2026-04-14

## Overview
[Project name, purpose, key features — 500 chars max]

## Installation & Setup
[Install steps, required tools — 500 chars]

## Essential Commands
```bash
npm run dev
npm run build
npm run test

Stack & Architecture

[Framework, ORM, DB, key patterns — 800 chars]

Project Rules (CLAUDE.md)

[Key conventions, gotchas — 1000 chars]

Current Backlog

[Top 5-10 priority items from docs/todo.md]

Links & Resources

[Relevant docs, external references]


Taille totale : 15K characters max (~4-5K tokens quand chargé dans Claude).

### 5. (Optionnel) Audit complet de /docs

Si vous voulez aussi auditer la doc :

```bash
/ulk:friday mode=audit

Produit rapport :

=== Audit /docs ===

✅ Files      : 12 fichiers markdown
⚠️ Missing    : No architecture.md, No glossary.md
✅ Frontmatter: 10/12 avec YAML valide
❌ Duplicates : None
✅ Health    : B+ (bon état)

Recommendations:
  - Add architecture.md (détailler patterns)
  - Generate glossary from code

6. (Optionnel) Nettoyage et réorganisation

Mode cleanup :

/ulk:friday mode=clean

Friday supprime :

Fichiers vides
Doublons détectés
Fichiers obsolètes (> 6 mois sans modification)

Produit rapport avant confirmation.

7. Utilisation du contexte en session future

En nouvelle session, chargez le contexte :

@docs/context.md

Reprendre le dev : [votre tâche]

Claude charge les 15K chars directement sans rescanner le projet.

Exemple de sortie

docs/context.md généré :

# Project Context — ulk toolkit

## Overview
**ulk** is an AI-assisted development toolkit — 45+ specialized agents for Claude Code.
Lightweight monorepo (no package.json). Focus: docs, audits, orchestration.

## Installation
```bash
git clone https://github.com/izo/ulk.git
cd ulk
./install.sh                    # Install agents + skills
./install.sh --with-vps         # + VPS agents
./install.sh --with-memory-loop # + memory persistence

Essential Commands

./install.sh                     # Install (Figma, Swift, Flutter bundled)
./install.sh --check             # Diagnostic
node cheatheet/generate-unified-docs.js  # Generate ulk.md

Stack

Language: Markdown, Bash, Node.js (docs)
Structure: Monorepo agents/ packages/ site/ community-skills/
Key agents: bruce (25, orchestrator), shuri (01, docs), sargeras (45, audit)

Rules (from CLAUDE.md)

Priority: CLI (0 tokens) > MCP > LLM
No package.json (intentional dependency-free)
Agent phases: define → plan → build → verify → review → ship
Memory: 8 agents with local persistence

Current Backlog (Top 5)

Validate flutter testing skills integration
Add vision audit to frontend agents
Document lovecraft memory protocol
Expand OWASP checklists
Test agent teams (experimental)

Links

Registry: agents/registry.json
Docs: https://izo.github.io/ulk/
Memory protocol: agents/_shared/memory-protocol.md


Rapport Friday :

=== Context Capture Complète ===

📄 Context generated : docs/context.md (14.8 KB / 15 KB max) ✅ Compression optimal : 5-6K tokens en session future 📊 Sources lues : 8 fichiers ⏱️ Extraction time : 2.4s (avec apfel optimization)


## Variantes

- **Variante A — Contexte slim** : Mode `context` + `--max-size=8000` pour ultra-compact (8K chars).
- **Variante B — Full audit** : Combiner `mode=context` + `mode=audit` pour capture + diagnostic.
- **Variante C — Scheduled** : Utiliser `/schedule context-capture` pour capture quotidienne automatique.
- **Variante D — Obsidian export** : Piping vers `obsidian-vault (39)` pour transformer docs/ en vault.

## Agents enchaînés

Flux typique : `friday (09)` contexte → `lovecraft (47)` memory loop → `godspeed (00)` diagnostic → `bruce (25)` orchestration.

## Troubleshooting

| Symptôme | Cause probable | Résolution |
|----------|----------------|------------|
| Context.md trop volumineux (> 15K) | Trop de sources lues | Limiter avec `--exclude` ou réduire frontmatter |
| apfel non trouvé | macOS < 26 ou non installé | Installer : `brew install Arthur-Ficial/tap/apfel` |
| CLAUDE.md non extrait | Fichier absent | Créer CLAUDE.md via `claude-md-optimizer (42)` |
| Docs désorganisés | Pas d'audit avant contexte | Lancer `mode=audit` d'abord, corriger, puis contexte |

## Voir aussi

- `agents/docs/09-friday.md` — gestionnaire documentation complet
- `agents/docs/01-shuri.md` — génération spec/todo
- `agents/orchestrators/47-lovecraft.md` — Obsidian vault + memory loop
- `agents/orchestrators/00-godspeed.md` — diagnostic projet