6.9 KiB
Documentation KSP
Ce fichier est le point d'entrée du répertoire docs/.
Le préfixe 000- est volontaire : la documentation est destinée à devenir volumineuse et cette convention maintient le point d'entrée en première position dans les listings, arbres de fichiers et classements lexicaux usuels. Dans les répertoires documentaires où un ordre explicite est utile, d'autres fichiers prioritaires peuvent utiliser 001-, 002-, etc. ; 000-README.md reste toujours prioritaire. Cette convention ne s'applique pas aux fichiers situés à la racine du dépôt.
Rôle de docs/
Le répertoire contient la documentation durable du projet : règles détaillées, idées à explorer, architecture, références, décisions, guides, plans et validations.
Les documents temporaires d'une livraison ne sont pas stockés sous docs/. Ils sont enregistrés sous deltas/ afin de conserver un seul historique de livraison pour l'ensemble du dépôt.
Organisation
docs/
├── 000-README.md
├── IDEAS.md
├── architecture/
│ ├── 000-README.md
│ ├── 001-PROJECT_OBJECTIVES.md
│ ├── 002-LAYERS_AND_DEPENDENCIES.md
│ ├── 003-COMPONENT_CONTRACTS.md
│ ├── 004-COMPONENT_INVENTORY.md
│ ├── 005-DEPENDENCY_GRAPH.md
│ ├── 006-WIRE_AND_PROGRAM.md
│ ├── 007-EXECUTION_AND_POLICY.md
│ ├── 008-DATA_MATERIALIZATION_AND_STORE.md
│ ├── 009-ACQUISITION_WORKERS_AND_JOBS.md
│ └── 010-APPS_SERVICES_SCENARIOS_AND_CONTROL.md
├── plans/
│ ├── 000-README.md
│ ├── 001-V0_0_3_PLAN.md
│ ├── 002-FUNCTIONAL_RELEASE_SEQUENCE.md
│ ├── 003-V0_1_1_CORE_FOUNDATION_PLAN.md
│ ├── 004-V0_1_2_LOGGING_FOUNDATION_PLAN.md
│ ├── 005-V0_1_3_CONFIG_FOUNDATION_PLAN.md
│ ├── 006-V0_1_4_CONFIG_DESKTOP_PLAN.md
│ ├── 007-V0_2_0_SERIES_PLANNING.md
│ ├── 008-V0_2_1_ONCHAIN_HTTP_PLAN.md
│ ├── 009-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER_PLAN.md
│ └── 010-V0_2_3_HTTP_TRANSACTIONS_PLAN.md
├── validation/
│ ├── 000-README.md
│ ├── 001-V0_1_4_CONFIG_DESKTOP.md
│ ├── 002-V0_2_0_SERIES_PLANNING.md
│ ├── 003-V0_2_1_ONCHAIN_HTTP.md
│ ├── 004-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER.md
│ ├── 005-V0_2_3_KSP_TRANSPORT_007_RETRO_AUDIT.md
│ └── 006-V0_2_3_HTTP_TRANSACTIONS.md
└── rules/
├── FILE_CONTRACTS.md
├── PROMPT_STRUCTURE.md
├── RULES_DEPENDENCIES.md
├── RULES_DOCUMENTATION.md
├── RULES_GENERAL.md
├── RULES_KSP.md
├── RULES_RUST.md
├── SCENARIO_CONVENTION.md
└── VERSION_WORKFLOW.md
D'autres sous-répertoires seront ajoutés uniquement lorsque leur rôle aura été décidé, notamment pour les références, décisions, guides et validations.
Documents de planification
Le plan historique de la phase fondatrice clôturée est conservé dans plans/001-V0_0_3_PLAN.md. La séquence active des premières releases fonctionnelles est définie dans plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md. Le plan détaillé de la release stable 0.1.1 est conservé comme historique clôturé dans plans/003-V0_1_1_CORE_FOUNDATION_PLAN.md. Le plan détaillé de la release stable 0.1.2 est conservé comme historique clôturé dans plans/004-V0_1_2_LOGGING_FOUNDATION_PLAN.md. Le plan détaillé de la release stable 0.1.3 — Configuration foundation est conservé comme historique clôturé dans plans/005-V0_1_3_CONFIG_FOUNDATION_PLAN.md. Le plan détaillé de la release stable 0.1.4 — ksp-app-config-desk est conservé comme historique clôturé dans plans/006-V0_1_4_CONFIG_DESKTOP_PLAN.md, avec sa matrice finale validation/001-V0_1_4_CONFIG_DESKTOP.md. Son prompt d'ouverture historique reste ../prompts/004-V0_1_4_START_PROMPT.md. La release stable 0.2.0 clôt l'audit de bot3 et le découpage de la série. Son plan directeur est conservé comme historique clôturé dans plans/007-V0_2_0_SERIES_PLANNING.md, avec sa matrice finale validation/002-V0_2_0_SERIES_PLANNING.md. La release stable 0.2.1 — HTTP Solana foundation a été ouverte par ../prompts/006-V0_2_1_START_PROMPT.md. Son gate de sizing et sa matrice exhaustive sont conservés dans plans/008-V0_2_1_ONCHAIN_HTTP_PLAN.md, avec la validation finale validation/003-V0_2_1_ONCHAIN_HTTP.md, README/USAGE Transport et le smoke Devnet opt-in de composition Config -> Transport. Le prompt ../prompts/007-V0_2_2_START_PROMPT.md a ouvert la release stable 0.2.2 — HTTP Accounts + Tokens + Cluster. Son plan clôturé plans/009-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER_PLAN.md conserve l'audit et l'implémentation des 22 wrappers typés, tandis que validation/004-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER.md enregistre les validations déterministes, les graphes Cargo et les deux smokes Devnet passés avant publication. Le prompt ../prompts/008-V0_2_3_START_PROMPT.md ouvre 0.2.3 — HTTP Transactions. Son plan candidat plans/010-V0_2_3_HTTP_TRANSACTIONS_PLAN.md conduit les 11 wrappers jusqu'à pre.009; le réaudit validation/005-V0_2_3_KSP_TRANSPORT_007_RETRO_AUDIT.md confirme la complétude des 37 wrappers HTTP typés et validation/006-V0_2_3_HTTP_TRANSACTIONS.md porte la matrice de clôture candidate. Le prompt ../prompts/009-V0_2_4_START_PROMPT.md prépare la dernière release de complétude HTTP.
IDEAS.md conserve les pistes et questions qui ne sont pas encore des engagements du roadmap ni des décisions architecturales.
Prompts
Les prompts de reprise eux-mêmes sont conservés sous ../prompts/.
Leur contrat de rédaction, de dimensionnement et de cycle de vie est défini dans rules/PROMPT_STRUCTURE.md.
Documents normatifs
Les règles sont indexées depuis ../RULES.md. Aucun document de brainstorming, plan ou delta ne devient normatif uniquement parce qu'il existe dans le dépôt.