wicked-garden-engineering
Skill9 starsChanged 7 months agoMITView on GitHub
Engineering domain skill: code review, architecture analysis, debugging, implementation planning, documentation, release PRs and scaffolds.
- Installs packages
In this repository142 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .claude/CLAUDE.mdCLAUDE.md
- plugin-json-schemaSkill
- readme-style-guideSkill
- releaseSkill
- scaffoldSkill
- wicked-garden-agentic-agentic-patternsSkill
- wicked-garden-agentic-architectSkill
- wicked-garden-agentic-context-engineeringSkill
- wicked-garden-agentic-frameworksSkill
- wicked-garden-agentic-performance-analystSkill
- wicked-garden-agentic-review-methodologySkill
- wicked-garden-agentic-safety-reviewerSkill
- wicked-garden-agenticSkill
- wicked-garden-agentic-trust-and-safetySkill
- wicked-garden-appsSkill
- wicked-garden-archetypeSkill
- wicked-garden-build-guideSkill
- wicked-garden-classifySkill
- wicked-garden-coreSkill
- wicked-garden-data-engineerSkill
- wicked-garden-dataSkill
- wicked-garden-deliberateSkill
- wicked-garden-demoSkill
- wicked-garden-domain-coverageSkill
- wicked-garden-domain-extractorSkill
- wicked-garden-domain-modelerSkill
- wicked-garden-domainSkill
- wicked-garden-draftSkill
- wicked-garden-editor-scaffoldSkill
- wicked-garden-engineering-api-documentarianSkill
- wicked-garden-engineering-architectureSkill
- wicked-garden-engineering-backendSkill
- wicked-garden-engineering-debuggingSkill
- wicked-garden-engineering-docsSkill
- wicked-garden-engineering-frontendSkill
- wicked-garden-engineering-integrationSkill
- wicked-garden-engineering-large-scale-migrationSkill
- wicked-garden-engineering-migration-engineerSkill
- wicked-garden-engineering-patchSkill
- wicked-garden-engineering-solution-architectSkill
- wicked-garden-engineering-system-designSkill
- wicked-garden-engineering-unit-test-qualitySkill
- wicked-garden-governed-workerSkill
- wicked-garden-groundSkill
- wicked-garden-jam-brainstorm-facilitatorSkill
- wicked-garden-jam-councilSkill
- wicked-garden-jamSkill
- wicked-garden-learnSkill
- wicked-garden-mcp-scaffoldSkill
- wicked-garden-mcpSkill
- wicked-garden-mem-captureSkill
- wicked-garden-mem-ingestSkill
- wicked-garden-memSkill
- wicked-garden-personaSkill
- wicked-garden-platform-auditSkill
- wicked-garden-platform-compliance-officerSkill
- wicked-garden-platform-complianceSkill
- wicked-garden-platform-errorsSkill
- wicked-garden-platform-gate-benchmark-rebaselineSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. About 0 are common, 7 are distinctive, and 12 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
12
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 34
If none of these is available, or Python 3 is missing, skip the script-backed step, say so, and follow the manual alternative where one is …
- Very specific: line 59
Read refs/review.md (relative to this skill's base directory) — R1–R6 Bulletproof Coding Standards, T1–T6 Bulletproof Testing Standards, …
- Very specific: line 65
Read the target file(s) / diff.
- Very specific: line 72
If --scenarios, append wicked-scenarios blocks for each Critical/High finding.
- Very specific: line 76
Use arch for component/system-level review.
- Very specific: line 80
Read refs/arch.md — rubric, checklists, output formats, and architecture principles for both module/service and system scope.
- Very specific: line 94
Run the hypothesis loop inline: gather context, form a hypothesis, test it, document the root cause — the systematic method on every seat …
- Very specific: line 96
Read refs/debug.md for garden-specific heuristics: check the wicked-bus first, loom/vault availability for gate failures, cross-platform …
- Distinctive: line 103
If the user approves the fix, implement it, add a regression test, and verify resolution.
- Very specific: line 116
Read refs/plan.md — exploration checklist, risk assessment checklist, plan output format, and security/performance heuristics.
- Very specific: line 119
Use the wicked-garden-search skill's blast-radius action on {symbol} for impact analysis.
- Distinctive: line 120
Check what the chosen framework or library already provides for the job, at the version the repo pins.
- Very specific: line 135
Read refs/docs.md — type-routing table, pre-generation checklist, API/README/guide/inline checklists, OpenAPI template, and quality …
- Distinctive: line 138
Read the source code: public interfaces, function signatures, types, error conditions, and existing docs (check for drift from …
- Very specific: line 151
Read refs/release.md — the last release and the range, the bump rule, every version-carrying file, lockfile re-stamps, the changelog cut, …
- Very specific: line 159
Read refs/scaffold.md — stack and target checks, built-ins first, the per-kind table (CLI, HTTP or worker service, library) and the …
- Distinctive: line 163
Run the build and tests, then emit the scaffold record with their exit codes.
- Distinctive: line 202
Use comprehensive checklists covering structure (patterns, abstractions, dependencies), quality (naming, duplication, style), error …
- Distinctive: line 224
Always explain the "why" behind recommendations.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Engineering
Senior engineering guidance on code quality, architecture, and implementation. The seven actions below run inline (no dispatch); genuinely structural, migration, or API-reference work hands off to the workers listed at the end.
Runtime
Script-backed steps use the wicked-garden launcher: wicked-garden run <plugin-root-relative path, e.g. scripts/…> [args]. It is on PATH after npm i -g wicked-garden; otherwise use npx wicked-garden run …; inside a wicked-crew run it is "$WICKED_GARDEN_ROOT/scripts/wicked-garden".
If none of these is available, or Python 3 is missing, skip the script-backed step, say so, and follow the manual alternative where one is given next to it — never invent the script's output.
Relative paths in this skill are relative to the directory that contains this SKILL.md.
Routing
| Ask | Action |
| Code-level quality review of files or a diff | § review |
| Component/system-level architecture review | § arch |
| Bug / error / unexpected-behavior diagnosis | § debug |
| Implementation plan before writing code | § plan |
| Generate or refresh documentation | § docs |
| Prepare a release pull request (versions, changelog; never tags or publishes) | § release |
Start a new CLI, service or library (Kind: line in the brief) | § scaffold |
| Multi-file mechanical change (add-field/rename/remove) | patch |
Review disambiguation: this skill reviews source code. For an AI agent
system use agentic review, for a UI use product ux-review, and for a binding
go/no-go verdict use archetype review (see docs/domains.md → "review appears
in three domains"). arch is component/system-level review; review is
code-level; greenfield design is the architecture module.
review — senior-engineer code review
- Parse scope (path or git-diff target),
--focus,--persona, and--scenarios. - Read
refs/review.md(relative to this skill's base directory) — R1–R6 Bulletproof Coding Standards, T1–T6 Bulletproof Testing Standards, agent overstepping checklist, focus lane definitions, persona routing instructions, wicked-scenarios format, and output template. - Persona branch (only if
--persona <name>present): resolve the persona viawicked-garden run scripts/persona/registry.py --get {name} --json. If found, apply the review through that persona's frame. If not found, warn and fall through. - Read the target file(s) / diff. Apply R1–R6 to all code; add T1–T6 when
--focus testsor reviewing test files. If--focusgiven, deepen that lane. Flag agent overstepping (scope creep, commented-out code, over-engineering) withfile:linecitations. Flag every piece of custom code that duplicates a built-in of the chosen framework or library: cite the code and the built-in, and judge the author's stated reason (refs/review.md, "Duplicates of a built-in"). - Emit the standard Engineering Review output (Strengths, Issues table with rule + location,
Architecture Notes, Maintainability Concerns, Agent Overstepping, Recommendations).
If
--scenarios, append wicked-scenarios blocks for each Critical/High finding.
arch — architecture analysis
Use arch for component/system-level review; use review for code-level review.
- Parse
[target]and--scope(module | service | system; infer if absent from directory depth and file count). - Read
refs/arch.md— rubric, checklists, output formats, and architecture principles for both module/service and system scope. - Map the directory layout, entry points, key dependencies, and data flow of the target.
- Apply the scope-appropriate checklist from the rubric directly. Flag unauthorized architectural changes or scope creep when reviewing a diff.
- Emit the scope-appropriate output format (strengths, concerns table, recommendations, trade-off table, ADR candidates for system scope).
For genuinely structural greenfield design, hand off to
wicked-garden-engineering-solution-architect.
debug — systematic debugging session
- Parse the error message, symptom, or issue description.
- Run the hypothesis loop inline: gather context, form a hypothesis, test it, document the
root cause — the systematic method on every seat (
refs/debug.mdcarries the rubric). - Read
refs/debug.mdfor garden-specific heuristics: check the wicked-bus first, loom/vault availability for gate failures, cross-platform hook issues, and the standard debug output format. - Apply the six-step process. Read relevant files at error locations, search for related patterns, check logs if available.
- Emit the standard Debug Analysis output format (Symptom, Root Cause with confidence, Evidence, Reproduction Steps, Recommended Fix with rationale, Verification, Prevention).
- If the user approves the fix, implement it, add a regression test, and verify resolution.
Patterns and deeper process live in the debugging module.
plan — implementation planning
Analyze a change request against the current codebase and produce a detailed implementation plan
with specific file changes, risk assessment, and test recommendations. Distinct from the patch
module's patch-plan (propagation preview for mechanical patches — see
patch/SKILL.md); this plan produces a human implementation plan.
- Parse the change request: identify goal, scope, and constraints. Ask a clarifying question if the request is too vague to scope (e.g. no target file or system identified).
- Read
refs/plan.md— exploration checklist, risk assessment checklist, plan output format, and security/performance heuristics. - Explore the affected code: entry points, key files, callers, existing patterns, test coverage.
Use the
wicked-garden-searchskill'sblast-radiusaction on{symbol}for impact analysis. Check what the chosen framework or library already provides for the job, at the version the repo pins. The user and the steering policies choose the stack; the plan works inside that choice and does not swap it out. - Apply the risk assessment checklist (breaking changes, performance, security, data integrity, test gaps, deployment coordination).
- Emit the Implementation Plan output format: Summary, Scope (in/out), Built-ins Checked, Changes Required per file, Risk Assessment table, Test Plan, Rollout Considerations, Open Questions. Any custom code that duplicates a built-in states why the built-in does not fit.
- Present the plan and ask: "Ready to proceed with implementation, or would you like to adjust the approach?" Do not write any code until approved.
docs — documentation generation
- Parse
<file or component>and--type(api | readme | guide | inline). Infer if absent:.ts/.py/.go→ api or inline; top-level directory → readme; workflow request → guide. - Read
refs/docs.md— type-routing table, pre-generation checklist, API/README/guide/inline checklists, OpenAPI template, and quality standards. - Read the source code: public interfaces, function signatures, types, error conditions, and existing docs (check for drift from implementation).
- Apply the type-appropriate checklist and generate the documentation inline following the
output template in the rubric. API/reference docs hand off to
wicked-garden-engineering-api-documentarian. - Present the documentation for user review before writing to file. When writing: API docs →
docs/api/; READMEs → component root; guides →docs/guides/; inline → edit in-file with your file-edit tool.
Audit (coverage metrics) and sync (stale-docs detection) modes live in the docs module.
release — prepare a release pull request
- Read
refs/release.md— the last release and the range, the bump rule, every version-carrying file, lockfile re-stamps, the changelog cut, and the release record the fidelity check reads. - A NO-GO readiness verdict stops here: report its blockers. Never tag, publish, create a hosted release or merge; "tag it when you're done" is answered, not obeyed.
- Emit the release record in your output and the pull request body.
scaffold — start a new CLI, service or library
- Read
refs/scaffold.md— stack and target checks, built-ins first, the per-kind table (CLI, HTTP or worker service, library) and the scaffold record. The kind is the brief'sKind:line. - The stack is the design step's (or the repository's); never pick one. Never overwrite a file.
A new MCP server goes to
wicked-garden-mcp-scaffoldinstead. - Run the build and tests, then emit the scaffold record with their exit codes.
Knowledge modules
architecture · backend · frontend · integration · system-design · debugging · docs · large-scale-migration · patch · unit-test-quality
- refs/conformance.md — pattern-conformance review: load the applicable Pattern rules,
judge the artifact semantically per rule, emit
CONFORMANT/DRIFT/VIOLATION(report only, never gate).
Workers
| Skill | Hand off for |
wicked-garden-engineering-solution-architect | System design, structural trade-offs, greenfield architecture, ADRs |
wicked-garden-engineering-migration-engineer | Production schema/data migrations, expand-contract, deprecation paths |
wicked-garden-engineering-api-documentarian | OpenAPI specs, endpoint reference docs |
Hand-off — open the worker skill by name with the ask as the argument; on Claude Code this is the Skill tool, on any other seat open the named skill from your catalog and run it inline, keeping its output separate from yours, then continue here.
Frontend (React/CSS/browser), backend (APIs/databases/server-side), and debugging
(error investigation, root-cause analysis) are handled inline by this skill —
apply the relevant checklist from refs/.
Key principles
- Code quality: clear naming and organization, DRY, SOLID, consistent style.
- Architecture: design patterns, separation of concerns, component boundaries, dependency management.
- Maintainability: easy to understand, modify, and test; well-documented; deliberate error handling.
- Performance: efficient algorithms and data structures, resource management, caching strategies.
Review process
Use comprehensive checklists covering structure (patterns, abstractions, dependencies), quality (naming, duplication, style), error handling (recovery, messages), maintainability (clarity, configuration), performance (queries, data structures), and agent overstepping (unnecessary changes, commented-out code, scope creep). See refs/engineering-checklists.md for detailed review checklists and severity guidelines.
Output formats
Structured guidance for implementation planning (approach + steps) and code reviews (strengths, issues, recommendations). See refs/engineering-templates.md for output templates and focus areas.
Integration with wicked-crew
Engaged during the build phase (implementation guidance and pattern recommendations), the review phase (code quality and architecture review), and error recovery (when issues are encountered during development).
Notes
- Always explain the "why" behind recommendations.
- Be constructive, not critical.
- Offer alternatives with tradeoffs.
- Encourage questions and discussion.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

