Spexso

Appearance

De codebase nalopen op architectuur ​

Agents schrijven snel code — en dus ook snel een kluwen. /spexso-architecture loopt je codebase na op plekken die moeilijk te veranderen of te testen zijn, toont ze in een visueel rapport, en zet wat jij kiest op de backlog.

Steps ​

  1. Start de review — op de plekken die het meest veranderen, of op een gebied dat je zelf kiest:
    /spexso-architecture
/spexso-architecture srv/leave
  2. Claude kiest de gebieden (git-historie, spexso-debt-markers in .spexso/debt.md, de hotspots uit de config), leest GLOSSARY.md, de ADR's in docs/adr/ en de open tech-debt issues, en laat een subagent de code verkennen. Hij zoekt naar ondiepe modules (een interface die bijna even groot is als wat erachter zit), begrippen die over veel kleine bestanden versnipperd zijn, koppelingen die doorlekken, en code die moeilijk via haar interface te testen is — met oog voor CAP en UI5 (doorgeef-handlers, regels verspreid over veel entity-handlers, controllers vol logica).
  3. Je browser opent een HTML-rapport: per voorstel de bestanden, een voor/na-schema, het probleem, de oplossing, de winst en een sterkte (Strong / Worth exploring / Speculative), en bovenaan een aanbeveling welk voorstel eerst.
  4. Per voorstel kies je:
    • Issue — wordt een type::tech-debt-issue in stage::opportunity; verfijn het later met /spexso-brainstorm {id}.
    • Nooit — je geeft de reden; die wordt een ADR in docs/adr/ (via een MR), zodat een volgende review het niet opnieuw voorstelt.
    • Later — niets vastgelegd; een volgende review mag het opnieuw vinden.
  5. Claude meldt het pad van het rapport, de aangemaakte issues en de ADR-MR.

TIP

Draai het na een marathon of voor een groot traject. De woordenschat die het gebruikt (module, interface, depth, seam, …) staat in .spexso/rules/architecture.md; de planner gebruikt dezelfde woorden als hij nieuwe modules plant.

Wat het niet doet ​

  • Code wijzigen: het rapport is een overzicht, de refactor loopt via het issue (brainstorm → start → build).
  • Het rapport bewaren: het staat in je tijdelijke map. Wat blijft zijn de issues en de ADR's.