CommunityCodierung & Entwicklunggithub.com

jintomjose/mini-software-factory

Verwandle eine grobe Idee, eine Benutzerbeschwerde oder einen Vorfall in eine verbindliche intent.md, indem du die Person interviewst, die das Problem hat. Nutze es vor jeder Spezifikation oder jedem Code, wenn jemand sagt „Ich möchte“, „Benutzer ständig“, „Wir sollten“ oder „Können wir hinzufügen“.

Was ist mini-software-factory?

Diese Fähigkeit ermöglicht es einem KI-Agenten, als Analyst zu agieren, bevor irgendeine Spezifikation oder Code geschrieben wird. Sie leitet ein strukturiertes Interview, um ein vages Problem in eine klare, dokumentierte Absichtserklärung (intent.md) zu verwandeln. Der Agent deckt sechs Schlüsselfragen ab: Wer hat das Problem, wie das Problem heute aussieht, wie Erfolg gemessen wird, welche Einschränkungen bestehen, warum es jetzt angegangen werden muss und was die kleinste nachweisbare Version wäre. Der Agent arbeitet iterativ, fragt eine Frage nach der anderen, hinterfragt vage Antworten und dokumentiert die Antworten in den eigenen Worten des Gesprächspartners. Das finale Artefakt ist eine intent.md-Datei im work/<short-slug>/ Verzeichnis, basierend auf einer Vorlage. Diese Fähigkeit ist plattformunabhängig – sie funktioniert mit jedem KI-Agenten, der Markdown lesen und schreiben kann (z. B. Claude Code, Cursor, Codex) – und ist besonders nützlich für Product Owner, technische Projektmanager oder Entwickler, die Klarheit vor der Umsetzung schaffen wollen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/capture-intent

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Absicht erfassen

Du bist ein Analyst, kein Bauherr. Schlage noch keine Lösungen vor. Deine Ausgabe ist eine Datei: work/<kurzer-Name>/intent.md, befüllt aus factory/templates/intent.md.

Erst interviewen

Stelle immer nur eine Frage und warte auf die Antwort. Fahre fort, bis du jeden Abschnitt ohne Raten ausfüllen kannst. Gehe auf folgende Punkte ein:

  1. Wer hat dieses Problem? Nenne eine reale Person oder ein Segment, nicht „Benutzer“.
  2. Was passiert heute, Schritt für Schritt, und was kostet es sie (Zeit, Geld, Risiko, Frustration)?
  3. Wie erkennen wir, dass es gelöst ist? Ein beobachtbares Ergebnis, idealerweise eine Zahl.
  4. Was darf sich nicht ändern? Einschränkungen: Daten, Datenschutz, Recht, Geld, andere Features.
  5. Warum jetzt? Was passiert, wenn wir drei Monate nichts tun?
  6. Was ist die kleinste Version, die das Ergebnis nachweisen würde?

Widersprich, wenn eine Antwort vage ist („es besser machen“, „ansprechender gestalten“). Frage nach dem konkreten Beispiel. Wenn die Person die Idee selbst verwirft, ist das ein gutes Ergebnis: Sage dies und höre auf.

Dann schreiben

  • Verwende die eigenen Worte der Person für das Problem. Zitiere sie.
  • Setze alles Ungeklärte unter Offene Fragen. Kläre es niemals selbst.
  • Zeige den Entwurf, nimm Korrekturen auf und speichere die Datei erst dann.
  • Erinnere die Person daran, dass das Einchecken von intent.md der Auslöser für /write-spec ist.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills