Skip to content

Repository files navigation

typ uebersicht
status entwurf
datum 2026-07-06

denkspur

Eine Methode, Projekte so zu führen, dass Mensch und KI-Agent sie jederzeit wieder aufnehmen und fortschreiben können: Struktur für den Raum (wo liegt was), Spur für die Zeit (warum ist es so).

Der übliche Verlust in Projekten ist Kontext. Entscheidungen stehen nur im Chat-Verlauf, Ablagen wachsen ungeplant, und jede neue Session mit einem Kollegen oder einem KI-Agenten beginnt mit demselben teuren Wieder-Erklären. denkspur setzt dagegen eine einfache Grundregel: Kontext gehört in die Ablage, nicht in den Chat. Jeder Gedanke bekommt dort einen vorhersehbaren Ort und einen nachvollziehbaren Lebenslauf.

Aufbau dieses Repos

Pfad Inhalt
leitfaden.md Der didaktische Einstieg — hier anfangen
methode/ Die Referenz in vier Kapiteln: Vertrag, Struktur, Lebenslauf, Zusammenarbeit
ideen/, entscheidungen/, plaene/ denkspur wendet die Methode auf sich selbst an — hier liegen die eigenen Gründungsentscheidungen
uebersicht.md Generierter Statusindex über alle Artefakte
logbuch.md Formloses Arbeitstagebuch, neueste Einträge zuerst
starter/ Kopierbares Skelett für den eigenen Projektstart (inkl. Vorlagen und Skripten)
AGENTS.md Kurzreferenz für KI-Agenten, die in einem denkspur-Projekt arbeiten
CHANGELOG.md Versionen mit „Adopter-Migration"-Hinweisen

Schnellstart

  1. leitfaden.md lesen. Er motiviert das Problem, baut die Methode Schritt für Schritt auf und führt ein Beispiel von der ersten Idee bis zur fertigen Umsetzung durch.
  2. Den Inhalt von starter/ in das eigene Projekt kopieren.
  3. Platzhalter in README.md und AGENTS.md füllen, erste Idee unter ideen/ festhalten. Der Rest ergibt sich aus der Arbeit.

Herkunft

denkspur ist eine Synthese aus zwei Quellen:

  • decision-trail (Christofer Kluth, Copyright HÄVG AG, MIT-Lizenz) — der Lebenslauf für Gedanken: Idee → Vorschlag → Entscheidung → Plan → Umsetzung, das Querverweis-Vokabular und die generierte Übersicht.
  • Private Struktur-Standards des Autors für KI-konsumierbare Ablagen: das Projekt-Skelett, die Namenskonventionen, das Frontmatter-Modell, die Datenklassen-Regeln und die Solo/Team-Skalierung.

Warum und wie beides zusammengeführt wurde, dokumentiert (der Methode entsprechend) Entscheidung 0001; die formale Attribution steht in NOTICE.

Ehrlichkeitshinweis zur eigenen Spur: Die Entscheidungen 0001–0003 entstanden gebündelt in der Gründungssitzung am 2026-07-06. Sie dokumentieren echte Abwägungen, aber keine über Zeit gereiften Fäden. Die Spur unter Realbedingungen beginnt mit Entscheidung 0004, den Konsequenzen aus dem ersten kritischen Review. Zustände wie verworfen und abgelehnt werden hier erst vorkommen, wenn sie wirklich eintreten — eine inszenierte Historie wäre das Gegenteil dessen, was die Methode verspricht.

Lizenz

MIT — siehe LICENSE.

About

Projektmethode fuer Mensch und KI-Agent: Struktur fuer den Raum, Spur fuer die Zeit. Synthese aus decision-trail (ADR-Lebenslauf) und Struktur-Standards fuer KI-konsumierbare Ablagen. Deutsch.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages