Noea Code kennenlernen — Noea Code Dokumentation

Noea Code (kurz Noea) hilft Ihnen, beim Entwickeln mit KI das Verhalten Ihrer Software zu verstehen und darüber zu entscheiden. Sie halten Anforderungen fest, ein Coding-Agent ändert den Code, und Sie prüfen anhand von Implementierungserläuterungen, Nachweisen und Hinweisen, ob das Ergebnis Ihren Erwartungen entspricht.

Beginnen Sie mit einer einzigen Regel in einem bestehenden Projekt. Ein Produktverhalten, eine Architekturbedingung oder eine Algorithmusanforderung kann Ihre erste Absicht sein.

Eine Absicht beschreibt Anforderungen, die Ihre Software dauerhaft erfüllen soll. Sie bleiben auch nach Fertigstellung einer Funktion relevant. Wenn Sie das Verhalten ändern möchten, ändern Sie die entsprechenden Formulierungen. Sie müssen nicht die gesamte Anwendung beschreiben: Beginnen Sie mit dem, was Ihnen wichtig ist.

Absicht und Implementierung verbinden

Angenommen, Sie entwickeln eine App für tägliche Check-ins und schreiben:

Nach 7 aufeinanderfolgenden Tagen mit Check-in erhält der Nutzer eine Belohnung.

Damit ist die Bedingung für eine Belohnung festgelegt. Offen bleibt jedoch, was als Tag zählt, was nach einem verpassten Check-in geschieht und welche Belohnung vergeben wird. Diese Entscheidungen muss der Agent bei der Implementierung trotzdem treffen.

Noea verknüpft den Satz mit einer Erläuterung der Implementierung. Sie können nachlesen, wie der Code Tage zählt, die zugrunde liegenden Codeverweise oder Testunterlagen öffnen und unerfüllte Anforderungen oder diskussionswürdige Entscheidungen erkennen. Wenn ein Tag dem lokalen Kalenderdatum des Nutzers entsprechen soll, ergänzen Sie diese Entscheidung in der Absicht, damit künftige Arbeiten sie berücksichtigen müssen.

Die drei Inhaltsarten kennen

Inhalt	Zweck	Ort
Absichtsdokumente	Gewünschtes Verhalten und Bedingungen festhalten	Bereich „Absichten“ der Seitenleiste; Dateien enden auf `.noea.md`
Implementierung	Code, Konfiguration und zugehörige Dateien der Software	Verknüpfter Implementierungsordner des Projekts
Implementierungserläuterungen	Beschreiben, wie die Implementierung eine Absicht erfüllt, einschließlich Nachweisen und Hinweisen	Randnotizen neben dem Absichtsdokument

Absichtsdokumente sind Markdown-Dateien. Sie können sie mit Git verwalten oder in einem anderen Editor bearbeiten. Noea speichert Implementierungserläuterungen separat und zeigt sie als Randnotizen. Manche Oberflächenbeschriftungen nennen die Absichtsdokumente Quelle (englisch „Source“); damit ist nicht der Code im Implementierungsordner gemeint.

Der tägliche Arbeitsablauf

Absicht klären. Schreiben Sie sie direkt auf oder besprechen Sie sie mit dem Agenten und prüfen Sie die vorgeschlagene Formulierung.
Implementieren und verstehen. Lassen Sie den Agenten arbeiten, untersuchen Sie anschließend die Implementierung und lesen Sie Erläuterung, Nachweise und Hinweise.
Entscheidungen festhalten. Fragen Sie zu einem bestimmten Absatz nach, ergänzen Sie dauerhafte Anforderungen und setzen Sie Implementierung und Prüfung fort.

Falls der Code schon existiert, schreiben Sie die zu prüfende Anforderung auf und starten Sie Erläutern. Muss sie noch implementiert werden, verwenden Sie einen Chat oder die Aktion Umsetzen.

Sie können eine verstandene Entscheidung akzeptieren, ohne jedes Implementierungsdetail zu einer dauerhaften Anforderung zu machen. Unter Erläuterungen und Nachweise lesen erfahren Sie, was in Ihre Absicht gehört.

Die Rollen von Noea und Agent verstehen

Noea bietet den Arbeitsbereich zum Schreiben von Dokumenten, Besprechen von Entscheidungen, Prüfen von Änderungen und Lesen von Erläuterungen. Der Agent liest das Projekt, ruft Werkzeuge auf und ändert Code. Wählen Sie einen unterstützten Agenten und nutzen Sie dessen Modelle und Anmeldemethoden.

Im Vorschlagsablauf von Noea entscheiden Sie über Änderungen an Ihren Absichtsdokumenten. Sie können einen Vorschlag bearbeiten und annehmen oder verwerfen. Codeänderungen und Befehle hängen von den Fähigkeiten und Berechtigungseinstellungen des Agenten ab.

Implementierungserläuterungen ersetzen weder Tests noch die praktische Nutzung. Prüfen Sie die Nachweise für wichtiges Verhalten und verifizieren Sie es bei Bedarf.

Mit einer kleinen, wichtigen Frage beginnen

Wählen Sie etwas Überschaubares mit beobachtbarem Ergebnis: Wann wird eine Belohnung vergeben, wie wird unzureichender Lagerbestand behandelt oder welche Bedingung muss eine API erfüllen? Für den Rest des Projekts können Sie Ihren bisherigen Entwicklungsprozess beibehalten.

Als Nächstes: Installieren und vorbereiten und anschließend Ihr erster Arbeitsablauf.