Initial: desk + ncantu placeholder + per-project cursor configs

**Motivations:**
- Centraliser les fichiers Cursor (rules, skills, agents, commands, hooks) par user et par projet

**Root causes:**
- N/A

**Correctifs:**
- N/A

**Evolutions:**
- desk: rules, skills-cursor, agents, commands, hooks, argv/hooks/mcp.json
- ncantu: README placeholder
- 4NK_node, algo, builazoo, ia_local, lecoffre_ng, lecoffre_ng_pprod, lecoffre_ng_test: .cursor contents

**Pages affectées:**
- cursor/desk/, cursor/ncantu/, cursor/<project>/
This commit is contained in:
2026-03-03 23:29:29 +01:00
commit 785868b53b
114 changed files with 6455 additions and 0 deletions

View File

@@ -0,0 +1,100 @@
# Plan : Relecture scientifique minutieuse — conjoncture_collatz.md
## Contexte
Document : `v0/conjoncture_collatz.md` (~23444 lignes)
Règles : ` IA_agents/redaction scientifique.md`
Contrainte : ne pas supprimer d'information importante pour la démonstration.
## Objectif
Appliquer exhaustivement le guide de rédaction scientifique, chunk par chunk, avec une attention minutieuse à chaque règle.
## Stratégie de découpage
- Chunk size : 600800 lignes (plus fin que la skill par défaut)
- Découpage aux frontières de sections (`##`)
- Ordre : du début à la fin du document
## Checklist par chunk (à vérifier systématiquement)
### 3. Structure et forme
- [ ] Titres `## Introduction` ou `## Conclusion` sans « de … » → préciser l'objet
- [ ] Niveau `##` pour toutes les Introduction/Conclusion
### 3.2 Ton et neutralité
- [ ] Supprimer : auto-appréciation, jugement sur l'ouvrage, auto-promotion, auto-évaluation, justification éditoriale
- [ ] Supprimer : adresse au lecteur (« le lecteur », « on laisse au lecteur »)
- [ ] Supprimer : formules introspectives (« nous avons choisi », « notre approche »)
- [ ] Supprimer : auto-satisfaction (« comme si le chapitre répondait à une demande »)
- [ ] Reformuler en énoncés factuels neutres
### 3.3 Enchaînements
- [ ] « La continuation », « continuons ainsi », « on poursuit de la même manière » → introduction classique des étapes
- [ ] Enchaînement par le contenu mathématique, pas par formules méta
### 3.5 Formulations interdites
- [ ] Qualificatifs : « important », « majeur », « robuste », « rigoureux », « ambitieux », « contribution principale », « conceptuellement décisif »
- [ ] Justifications : « volontairement », « conservateur », « cette section sert de verrou », « priorité strictement »
- [ ] Éditorial : « discipline » (quand utilisé pour commenter l'édition, pas comme terme méthodologique)
### 4. Preuves
- [ ] « Il est facile de voir », « on laisse au lecteur » → détailler ou renvoyer à lemme/référence
- [ ] « On vérifie que » sans suite → compléter
### 7. Références
- [ ] « Il est bien connu que » → citer la source exacte ou reformuler
### 2. Hypothèses
- [ ] Avant chaque lemme/proposition/théorème : hypothèses explicites
- [ ] Dans la preuve : signaler l'usage de chaque hypothèse
### 10. Terminologie
- [ ] Un concept = un terme (pas de synonymes fluctuants)
### 15. Voix et temps
- [ ] Présent atemporel pour les énoncés mathématiques
- [ ] Voix uniforme (« on » ou passif)
## Exclusions (ne pas modifier)
- Contenu mathématique (définitions, lemmes, preuves, formules)
- « Verrouillage des futurs » et concepts théoriques associés
- « Verrou formel », « point à verrouiller » (sens technique)
- « Discipline » dans « discipline de déclaration des dépendances » (méthodologie)
- LaTeX, blocs de code, structure des équations
## Ordre d'exécution
1. Chunk 1 : lignes 11200
2. Chunk 2 : lignes 12012400
3. Chunk 3 : lignes 24013600
4. Chunk 4 : lignes 36014800
5. Chunk 5 : lignes 48016000
6. Chunk 6 : lignes 60017200
7. Chunk 7 : lignes 72018400
8. Chunk 8 : lignes 84019600
9. Chunk 9 : lignes 960110800
10. Chunk 10 : lignes 1080112000
11. Chunk 11 : lignes 1200113200
12. Chunk 12 : lignes 1320114400
13. Chunk 13 : lignes 1440115600
14. Chunk 14 : lignes 1560116800
15. Chunk 15 : lignes 1680118000
16. Chunk 16 : lignes 1800119200
17. Chunk 17 : lignes 1920120400
18. Chunk 18 : lignes 2040121600
19. Chunk 19 : lignes 2160122800
20. Chunk 20 : lignes 2280123444
## Méthode
Pour chaque chunk :
1. Lire le chunk
2. Parcourir ligne par ligne en appliquant la checklist
3. Appliquer les corrections via search_replace (match exact, préservation des caractères Unicode)
4. Passer au chunk suivant
## Livrable
Modifications appliquées directement dans `v0/conjoncture_collatz.md`. Pas de rapport séparé (conformément au guide : « ne fait pas de rapport des corrections »).

View File

@@ -0,0 +1,88 @@
---
name: document-improvement
description: Improves and corrects long text documents in background by processing them in chunks. Applies scientific writing rules, neutral style, and formatting corrections. Use when the user wants to improve, correct, or format large markdown/text documents, or when launching a background document processing task.
---
# Document Improvement (Background)
Improves and corrects long documents by processing them in chunks. Designed for scientific and technical texts (e.g. mathematical proofs, research notes).
## Invocation
**Background execution** (recommended for large files):
```
Use mcp_task with subagent_type="generalPurpose" and a prompt that:
1. References this skill
2. Specifies the document path
3. Optionally specifies chunk size (default: 8001200 lines) and scope (full document or line range)
```
**Direct invocation**: When the user asks to improve or correct a document, apply this workflow.
## Workflow
### 1. Analyze document structure
- Read the document to identify sections (headers `##`, `###`)
- Note total line count
- Identify natural break points (section boundaries)
### 2. Chunk strategy
For documents > 1500 lines:
- **Chunk size**: 8001200 lines per pass (adjust to fit section boundaries)
- **Overlap**: Include 23 lines of context at chunk boundaries
- **Order**: Process from start to end; preserve section continuity
For documents ≤ 1500 lines: process in one pass.
### 3. Per-chunk processing
For each chunk:
1. Read the chunk with surrounding context
2. Apply corrections from [reference.md](reference.md)
3. Write corrections using search_replace (exact match, minimal edits)
4. Preserve LaTeX, code blocks, and structural markup
### 4. Corrections to apply
See [reference.md](reference.md) for the full checklist. Main categories:
- **Titles**: "Introduction" → "Introduction de …", "Conclusion" → "Conclusion de …"
- **Neutrality**: Remove auto-appreciation, reader address, introspection
- **Enchainements**: Replace "La continuation ainsi…" by content-driven transitions
- **Hypotheses**: Explicit hypotheses before each result
- **References**: Exact citations, no vague "il est bien connu que"
### 5. Output
- Apply edits directly to the file
- Do not produce a separate report unless requested
- Preserve git history (one logical change per chunk if possible)
## Constraints
- **No content invention**: Only correct and reformulate; do not add new mathematical claims
- **Preserve structure**: Keep section hierarchy and numbering
- **Minimal edits**: Prefer targeted search_replace over full rewrites
- **Consistency**: Use the same terminology and conventions across chunks
## Chunk processing template
When processing chunk N (lines XY):
```
Chunk N/X: lines XY
- Sections in scope: [list]
- Corrections applied: [brief list]
- Next chunk: lines Y+1Z
```
## Error handling
- If a chunk fails: log the line range and error, continue with the next chunk
- If LaTeX or structure is ambiguous: skip and leave a comment for manual review
- Do not guess mathematical notation; preserve it exactly

View File

@@ -0,0 +1,40 @@
# Document Improvement — Usage Examples
## Launching as background task (mcp_task)
To process a document in background, use `mcp_task` with `subagent_type="generalPurpose"` and a prompt like:
```
Improve and correct the document at [PATH] following the skill at .cursor/skills/document-improvement/SKILL.md.
Read SKILL.md and reference.md from that directory, then apply the workflow:
1. Analyze the document structure
2. Process in chunks of ~1000 lines (or full document if < 1500 lines)
3. Apply all corrections from the reference checklist
4. Write edits directly to the file with search_replace
Document path: v0/conjoncture_collatz.md
```
**With specific scope:**
```
Same as above, but only process lines 1380013846 (last section).
```
## Direct invocation
When the user says "améliore ce document" or "corrige le document X":
1. Read `.cursor/skills/document-improvement/SKILL.md` and `reference.md`
2. Follow the workflow in SKILL.md
3. Process the document in chunks if needed
## Chunk size guidelines
| Document size | Strategy |
|---------------|----------|
| < 1500 lines | Single pass |
| 15005000 lines | 24 chunks of ~1000 lines |
| 500015000 lines | 515 chunks, break at section boundaries |
| > 15000 lines | Multiple sessions; process ~30005000 lines per session |

View File

@@ -0,0 +1,82 @@
# Document Improvement — Reference Checklist
Condensed rules for correcting scientific and technical documents. Source: project writing guide.
## Titles
| Incorrect | Correct |
|-----------|---------|
| ## Introduction | ## Introduction de [objet/section] |
| ## Conclusion | ## Conclusion de [objet/section] |
All Introduction and Conclusion titles must be at level `##`.
## Neutrality (strict)
**Remove or rewrite:**
- Auto-appreciation: "important", "majeur", "robuste", "rigoureux", "ambitieux"
- Editorial justification: "volontairement", "conservateur", "verrou", "discipline"
- Reader address: "le lecteur verra que…" → factual statement
- Introspection: "nous avons choisi…" → neutral formulation
- Meta-commentary on the text itself
**Use instead:**
- Factual: "On définit…", "On suppose…", "On montre…", "Il s'ensuit…"
- Structural references: "voir Chapitre X", "d'après la Proposition Y" (without evaluative terms)
## Transitions
- Replace "La continuation ainsi…" by content-driven transitions
- Each paragraph should follow from the mathematical content, not from meta-phrases
- Avoid "on poursuit de la même manière" without specifying what follows
## Hypotheses and results
- Before each lemma, proposition, theorem: state hypotheses explicitly
- In the proof: indicate when each hypothesis is used
- No implicit or "obvious" hypotheses
## References and citations
- Cite exact source (theorem, page, equation number)
- Avoid "il est bien connu que" without reference
- For overlap with literature: state the difference (hypotheses, framework) factually
## Quantifiers and domains
- Explicit quantifiers: "pour tout", "il existe", "il existe un unique" with clear domain
- Explicit domain of definition for functions and operators
- Validity conditions in the statement, not only in the proof
## Terminology
- One concept = one term throughout
- No fluctuating synonyms for the same object
- For long documents: recall local conventions at section start if needed
## Proofs
- No "il est facile de voir" or "on laisse au lecteur" without a precise pointer
- Either detail the argument or refer to a lemma/reference
- Long calculations: state the intermediate result, move details to appendix with reference
## Conjectures and open questions
- Neutral formulation: "On conjecture que…", "Il serait naturel de se demander si…"
- No overstatement of importance
- Limits of the framework: recall restrictive hypotheses in section conclusion if relevant
## Voice and tense
- Present atemporal for mathematical statements
- Uniform voice: either "on" or passive throughout
- Future only for explicit forward references ("on verra en 4.2 que…")
## Quick scan patterns
When scanning a chunk, flag:
- `## Introduction` or `## Conclusion` without "de …"
- "important", "majeur", "volontairement", "verrou", "discipline"
- "Le lecteur", "on laisse au lecteur", "il est facile de voir"
- "La continuation ainsi", "on poursuit de la même manière"
- "il est bien connu que" without citation