Skip to content

bruce48x/Lakona / .agents/skills/lakona-architecture-review

lakona-architecture-review

Verified

Perform an explicitly requested, read-only Lakona architecture and framework-health review; honor any specified reduced scope.

references/macro-architecture.md

View on GitHub
# 1. Macro Architecture

Map modules, interfaces, seams, adapters, package dependencies, ownership, and
lifetimes. Look for:

- duplicate models, owners, runtime graphs, or sources of truth
- shallow modules and pass-through interfaces
- seams with only one real adapter
- package or assembly splits without independent ownership
- hidden fallback providers, ambient state, global replacement, and friend
  access
- scattered startup, shutdown, rollback, cancellation, or disposal ownership
- public compatibility surfaces without active behavior
- extension points created speculatively
- documentation that describes a cleaner architecture than the code implements

Apply the deletion test: if deleting a module removes complexity instead of
concentrating it behind a smaller interface, treat it as suspect.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall