Skip to content

nWave-ai/nWave / nWave/skills/nw-ab-anti-patterns

nw-ab-anti-patterns

Verified

KNOWLEDGE — agent/skill/command anti-pattern catalog with fixes. Reference scanned by validate-spec; no sequence.

nw-ab-anti-patterns (KNOWLEDGE)

Kind: KNOWLEDGE (reference catalog). Scanned by nw-ab-validate-spec (anti-pattern step). No forced sequence.

Anti-PatternWhy It FailsFix
Monolithic agent (2000+ lines)Context rot; 3x token costExtract to Skills, target 200-400 lines
Embedded safety frameworksDuplicates platform; wastes tokensConstruct safety first — tool surface (frontmatter tools/permissionMode), typed grammar; hooks last resort (GDP-0)
Aggressive languageOvertriggering on Opus 4.6Calm, direct statements
Zero examplesFails on subtle/critical behaviorsInclude 3-5 canonical examples
Exhaustive examples (30+)Diminishing returns; context rotKeep 3-5 diverse canonical cases
Specifying default behaviors65% of specs redundantSpecify only divergent behaviors
Negatively phrased rulesLess effective than affirmativePhrase affirmatively
Compound instructionsConfuses agent reasoningSplit into separate focused steps
Inconsistent terminologyAmplifies confusion in longer contextsOne term per concept throughout
Mirrored skill loadingFrontmatter skill also loaded by a body directive or table row — the installer already preloaded it once, so the body duplicates resident knowledgeDelete the body directive/row; frontmatter alone keeps it resident
Handwritten conditional indexSkill Loading section or table written beside the generated region — two indexes driftApply the source-aware Skill addressing procedure in nw-agent-creation-workflow; retain one generated index and report missing source capability
Conditional skill in frontmatterA skill needed only under a condition is eagerly preloaded on every taskMove it to a precise conditional trigger through the source-aware procedure; do not manufacture a registry in an installed project
Over-compressed examples### Example N: headers removed during compression — eval tools can't find themKeep example section headers verbatim
Compressed AskUserQuestion optionsRuntime menu items compressed to pipes — lose decision tree structurePreserve numbered options with descriptions verbatim
Broad multi-job assetOne agent/skill does N jobs; runtime re-decides "what good means" each runSplit into N one-job-one-trigger INTERNAL skills — do not add rules, do not parameterize
Renaming/proliferating the command surfaceRenaming an established command (e.g. forge) or adding new user-facing commands breaks muscle-memory + the preserve-names ruleRoute the split to internal skills behind the EXISTING command/agent; preserve names; a new command is the rare exception, named /nw-*
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall