Das Nova Development Framework (NDF) ist ein dokumentations- und sicherheitsorientiertes Entwicklungs-Framework: Softwareprojekte werden mit KI-Unterstützung geplant, gebaut und gepflegt — unter durchgehender menschlicher Kontrolle. NDF ist projektneutral und wurde an realen Referenzprojekten validiert.
The Nova Development Framework (NDF) is a documentation-first, security-first development framework: software projects are planned, built, and maintained with AI assistance — under continuous human control. NDF is project-neutral and was validated against real reference projects.
KI-gestützte Entwicklung ist schnell, wird aber leicht unstrukturiert: Reviews werden zu Code-Umbauten, Features entstehen ohne Doku, gefährliche Funktionen ohne Schutzmaßnahmen. NDF beantwortet das mit kleinen, typisierten Work Packages, getrennten Rollen für Planung, Umsetzung und Freigabe sowie verpflichtenden Sicherheitsmustern.
AI-assisted development is fast but easily becomes unstructured: reviews turn into refactorings, features ship without documentation, dangerous operations get built without safeguards. NDF answers this with small, typed work packages, separate roles for planning, execution, and approval, and mandatory safety patterns.
- Documentation First — wichtige Entscheidungen werden dokumentiert, bevor sie dauerhaft werden.
- Architecture First — komplexe Arbeit wird erst geplant, dann umgesetzt.
- AI creates. Humans approve. — KI trifft keine irreversiblen Entscheidungen.
- Kleine, typisierte Work Packages — kein Work Package ohne deklarierten Typ.
- Security first, fail closed — riskante Funktionen brauchen explizite Sicherheitsmuster.
- Kontinuierliches Feedback — validierte Erfahrung fließt zurück ins Framework.
- Documentation First — important decisions are documented before they become permanent.
- Architecture First — complex work is planned before it is implemented.
- AI creates. Humans approve. — AI never makes irreversible decisions.
- Small, typed Work Packages — no work package without a declared type.
- Security first, fail closed — risky functionality requires explicit safety patterns.
- Continuous feedback — validated experience flows back into the framework.
- Nova (ChatGPT) — die ChatGPT-basierte Planungs-, Architektur- und Review-Rolle; spezifiziert Work Packages: Typ, Umfang, Akzeptanzkriterien.
- Implementation Agent (Umsetzung, z. B. Claude) — führt genau ein Work Package aus und berichtet strukturiert zurück.
- Menschlicher Maintainer (Review & Freigabe) — prüft, entscheidet GO / REWORK / SPLIT / STOP, committet und pusht.
Nova (ChatGPT) → Implementierungs-Agent → menschlicher Maintainer
Details zur Nova-Rolle: NOVA_CHATGPT_ROLE.md
- Nova (ChatGPT) — the ChatGPT-based planning, architecture and review role; specifies work packages: type, scope, acceptance criteria.
- Implementation Agent (execution, e.g. Claude) — executes exactly one work package and reports back in a structured format.
- Human Maintainer (review & approval) — reviews, decides GO / REWORK / SPLIT / STOP, commits and pushes.
Nova (ChatGPT) → Implementation Agent → Human Maintainer
Details on the Nova role: NOVA_CHATGPT_ROLE.md
Klassifizieren -> Planen -> Umsetzen -> Rückmeldung an Nova -> Review -> Commit
Kein Schritt wird übersprungen. Details: WORK_PACKAGE_LIFECYCLE.md
Classify -> Plan -> Execute -> Report to Nova -> Review -> Commit
No step is skipped. Details: WORK_PACKAGE_LIFECYCLE.md
Jedes Work Package hat genau einen primären Typ — er bestimmt erlaubte Änderungen, Testerwartung und Review-Tiefe. Beispiele: review-only, docs-only, code-fix, feature, security-baseline, destructive-blueprint, destructive-implementation, project-adapter. Vollständiger Standard: WORK_PACKAGE_TYPES.md
Every work package has exactly one primary type — it decides allowed changes, test expectations, and review depth. Examples: review-only, docs-only, code-fix, feature, security-baseline, destructive-blueprint, destructive-implementation, project-adapter. Full standard: WORK_PACKAGE_TYPES.md
Gefährliche Funktionen (Löschen, Bulk-Operationen, Irreversibles) werden nie direkt implementiert: erst destructive-blueprint, dann nach Freigabe destructive-implementation — mit strikter Validierung, Read-only-Preview, Owner-only-Autorisierung, Backup-vor-Delete und Audit-Logging. Werkzeuge: Destructive Action Toolkit · Security Prompt Library
Dangerous functionality (deletion, bulk operations, irreversible changes) is never implemented directly: first destructive-blueprint, then — after approval — destructive-implementation, with strict validation, read-only preview, owner-only authorization, backup-before-delete, and audit logging. Tools: Destructive Action Toolkit · Security Prompt Library
Der Project Adapter v0.2 überführt bestehende Projekte strukturiert nach NDF: von der read-only-Analyse über Project Profile, Manifest und Health Score bis zur ersten sicheren Work Package Queue. Guide: PROJECT_ADAPTER_V0_2.md
Project Adapter v0.2 brings existing projects into NDF in a structured way: from read-only analysis through project profile, manifest, and health score to the first safe work package queue. Guide: PROJECT_ADAPTER_V0_2.md
Ein automatischer Quality Gate schützt die öffentliche Neutralität dieses Repositories: Denylist-Scan (ohne private Begriffe im Repo), Root-Hygiene, History-Trennung und README-Struktur — lokal per Script, in CI bei jedem Pull Request. Doku: PUBLIC_QUALITY_GATE.md
An automated quality gate protects this repository's public neutrality: denylist scan (no private terms stored in the repo), root hygiene, history separation, and README structure — locally via script, in CI on every pull request. Docs: PUBLIC_QUALITY_GATE.md
- Foundation 0.1: released / frozen
- Foundation 0.2: ist als
v0.2.0-foundationFoundation Pre-Release veröffentlicht — Release Notes - Foundation 0.3: ist als
v0.3.0-foundationFoundation Pre-Release veröffentlicht — Release Notes - Foundation 0.4: ist als
v0.4.0-foundationFoundation Pre-Release veröffentlicht (Adoption Hardening & Public Usability) — Release Notes - Public Framework Cleanup: erledigt · Project Adapter v0.2: verfügbar · DE/EN-Angleichung: laufend
Struktur-Review: REPOSITORY_STRUCTURE_REVIEW.md — NDF ist bewusst noch kein v1.0.
- Foundation 0.1: released / frozen
- Foundation 0.2: published as the
v0.2.0-foundationfoundation pre-release — Release Notes - Foundation 0.3: published as the
v0.3.0-foundationfoundation pre-release — Release Notes - Foundation 0.4: published as the
v0.4.0-foundationfoundation pre-release (adoption hardening & public usability) — Release Notes - Public framework cleanup: done · Project Adapter v0.2: available · DE/EN alignment: in progress
Structure review: REPOSITORY_STRUCTURE_REVIEW.md — NDF is deliberately not v1.0 yet.
- Kernprinzipien und Rollenmodell oben lesen.
- Work-Package-Typen verstehen: WORK_PACKAGE_TYPES.md
- Bestehendes Projekt anbinden: PROJECT_ADAPTER_V0_2.md — Beispiel-Fixture: examples/neutral-example-project/
- Vorlagen und Prompts:
framework/templates/·framework/prompts/
- Read the core principles and role model above.
- Understand work package types: WORK_PACKAGE_TYPES.md
- Adapt an existing project: PROJECT_ADAPTER_V0_2.md — example fixture: examples/neutral-example-project/
- Templates and prompts:
framework/templates/·framework/prompts/
NDF wird zweisprachig (Deutsch/Englisch) geführt. Neue zentrale Dokumente sind bilingual oder klar sprachlich zugeordnet. Standard: DE_EN_LANGUAGE_STANDARD.md · Status: TRANSLATION_STATUS.md
NDF is maintained bilingually (German/English). New central documents are bilingual or clearly language-assigned. Standard: DE_EN_LANGUAGE_STANDARD.md · Status: TRANSLATION_STATUS.md
See LICENSE.