Verwendung
Einstieg in große Codebasen
Einrichtungs-Checkliste für große Codebasen mit Apothem: Kontexthierarchie, Skills, Hooks, Symbolsuche und Review-Kadenz.
Nutze diese Seite, wenn ein Repository für einen einzigen Prompt zu breit ist, Scans über den gesamten Baum kostspielig sind oder jeder Dienst eigene Build- und Testbefehle hat.
Hier beginnen
- Installiere oder aktualisiere den Ziel-Umgebungs-Adapter und führe dann
apothem verify --harness <name>aus. - Halte die Wurzel-Kontextfläche kurz: Projektkarte, kritische Befehle und nur Verweise.
- Lege lokale Konventionen neben den Code, wenn die Zielumgebung mehrschichtigen Kontext unterstützt.
- Verschiebe spezialisierte Abläufe nach
skills/,rules/oder in Befehlsdokumente mit Pfadfiltern. - Nutze schreibgeschützte delegierte Arbeiter für die breite Erkundung und bringe dann vor dem Bearbeiten eine kompakte Befundmenge zurück.
- Füge Ausschlüsse für Cache, generierte Dateien, Build und Vendor zur Ignore-Fläche der Umgebung hinzu, wo dies dokumentiert ist.
- Nutze LSP oder Symbolwerkzeuge, wenn verfügbar; andernfalls verwende
rg, eng gefasste Pfade und explizite Dateigeltungsbereiche. - Führe den engsten Lint- oder Testbefehl aus, der den berührten Code abdeckt; führe vor der Veröffentlichung das vollständige Gate aus.
Praxis-Übersicht
| Praxis | Apothem-Bindung |
|---|---|
| Schlanker, immer geladener Kontext | src/apothem/rules/token-budget-discipline.md hält die immer aktiven Regeln kurz; Wurzel-Kontextdateien sollten nur Verweise und kritische Stolperfallen enthalten. |
| Expertise auf Abruf | src/apothem/skills/README.md definiert die SKILL.md-Konvention; pfadgefilterte Begleitregeln halten eng gefasste Abläufe aus dem Basiskontext heraus. |
| Mehrschichtiger Kontext | Jede Umgebungszeile deklariert layered_context_surface in src/apothem/harnesses/<name>/capabilities.yml; STANDARD-CONVENTION-PIN.md bleibt die Autorität der Zeile. |
| Isolierte Erkundung | Der Leitfaden für delegierte Arbeiter bindet getrennte Kontextfenster und kompakte Rückgabeverträge. |
| Symbolnavigation | lsp_symbol_navigation ist eine verfolgte Fähigkeitszelle. Zeilen bleiben tracked-gap, bis eine herstellergestützte Plugin- oder Werkzeugfläche fixiert ist. |
| Ignore-Fläche | context_ignore_surface erfasst den dokumentierten Ausschlussmechanismus. Der Claude Code Adapter projiziert Ausschlüsse für generierte Dateien und Cache über permissions.deny in settings.json. |
| Hook-Lernen | Hooks der Pass-Klasse bleiben still. Wiederkehrende Befunde werden über den Artefakt-Evolutionszyklus in src/apothem/rules/persistent-conventions-vigilance.md geleitet. |
| Periodische Überprüfung | Führe alle drei bis sechs Monate sowie nach größeren Umgebungs- oder Modelländerungen eine Konfigurationsüberprüfung durch, unter Nutzung der *-maintenance-Plankadenz. |
Wartungshinweise
Die maschinenlesbare Umgebungs-Fähigkeitszeile trägt vier Zellen für große Codebasen:
context_ignore_surface, layered_context_surface, lsp_symbol_navigation
und hook_learning_capture. Halte diese Zellen mit der benachbarten
STANDARD-CONVENTION-PIN.md synchron, sobald sich eine Herstellerfläche ändert.
Quellverweise: Praktiken für große Codebasen, Einstellungsberechtigungen.