Skip to content

Commit 2762457

Browse files
raifdmuellerclaude
andcommitted
feat: add Socratic Code Theory Recovery contract
Recovers a program's "theory" (Naur 1985) from source code through recursive question refinement. Composes: Socratic Method, arc42, ISO 25010, Nygard ADRs, Mental Model (Naur). Two-phase workflow producing a Question Tree with [ANSWERED]/[OPEN] leaves and role-routed handoff document. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent d32b906 commit 2762457

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

website/public/data/contracts.json

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,17 @@
9898
"templateDe": "Dokumentation folgt Docs-as-Code nach Ralf D. Müller:\n- AsciiDoc als Format, PlantUML für Inline-Diagramme, gebaut von docToolchain\n- Versioniert, reviewt und automatisch gebaut\n- Gutes Deutsch nach Wolf Schneider (oder Plain English nach Strunk & White)",
9999
"category": "documentation"
100100
},
101+
{
102+
"id": "socratic-code-theory-recovery",
103+
"title": "Socratic Code Theory Recovery",
104+
"titleDe": "Sokratische Code-Theorie-Rekonstruktion",
105+
"description": "Recover a program's 'theory' from source code through recursive question refinement",
106+
"descriptionDe": "Die 'Theorie' eines Programms aus dem Quellcode durch rekursive Fragenverfeinerung rekonstruieren",
107+
"anchors": ["socratic-method", "arc42", "iso-25010", "adr-according-to-nygard", "mental-model-according-to-naur"],
108+
"template": "Recover a program's \"theory\" (Naur 1985) from source code through recursive question refinement.\n- Start with 5 high-level questions: Problem/Users, Specification, Architecture, Quality Goals, Risks\n- Decompose each question using Semantic Anchors as guides: arc42 (12 sub-questions), Cockburn Use Cases, ISO 25010, Nygard ADRs\n- Each leaf is either `[ANSWERED]` (with code evidence) or `[OPEN]` (with Category, Ask role, and why unanswerable)\n- The Question Tree is the primary artifact; documentation is synthesized from answered leaves\n- Open Questions are the handoff document: routed by role (Product Owner, Architect, Developer, Domain Expert, Operations)\n- Two-phase workflow: Phase 1 builds the tree, team answers Open Questions, Phase 2 produces documentation with Q-ID traceability",
109+
"templateDe": "Die \"Theorie\" eines Programms (Naur 1985) aus dem Quellcode durch rekursive Fragenverfeinerung rekonstruieren.\n- Start mit 5 High-Level-Fragen: Problem/Nutzer, Spezifikation, Architektur, Qualitätsziele, Risiken\n- Jede Frage mit Semantic Anchors als Leitfaden zerlegen: arc42 (12 Unterfragen), Cockburn Use Cases, ISO 25010, Nygard ADRs\n- Jedes Blatt ist entweder `[BEANTWORTET]` (mit Code-Evidenz) oder `[OFFEN]` (mit Kategorie, zuständiger Rolle und Begründung warum nicht beantwortbar)\n- Der Fragenbaum ist das primäre Artefakt; Dokumentation wird aus beantworteten Blättern synthetisiert\n- Offene Fragen sind das Übergabedokument: nach Rolle geroutet (Product Owner, Architekt, Entwickler, Domänenexperte, Operations)\n- Zwei-Phasen-Workflow: Phase 1 baut den Baum, Team beantwortet offene Fragen, Phase 2 erzeugt Dokumentation mit Q-ID-Rückverfolgbarkeit",
110+
"category": "documentation"
111+
},
101112
{
102113
"id": "concise-response",
103114
"title": "Concise Response (TLDR)",

0 commit comments

Comments
 (0)