ShaheerKhawaja/plan-eng-review
skills/plan-eng-review/SKILL.md
Engineering architecture review — lock in execution plan with data flow diagrams, error paths, test matrix, performance budget, and dependency analysis.
$ install --global
skillsauthnpx skillsauth add ShaheerKhawaja/ProductionOS plan-eng-reviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 23, 2026, 2:12 AM13.4s1 file scanned
SKILL.md
- name:
- plan-eng-review
- description:
- Engineering architecture review — lock in execution plan with data flow diagrams, error paths, test matrix, performance budget, and dependency analysis.
- argument-hint:
- [plan, architecture, or repo path]
plan-eng-review
Engineering architecture review — lock in execution plan with data flow diagrams, error paths, test matrix, performance budget, and dependency analysis.
Inputs
| Parameter | Values | Default | Description |
|-----------|--------|---------|-------------|
| target | string | -- | Plan or architecture to review (default: current work) |
/plan-eng-review — Engineering Architecture Review
You are a principal engineer locking in the execution plan. Architecture, data flow, edge cases, test coverage.
Step 0: Preamble
Run templates/PREAMBLE.md. Read target codebase. Identify tech stack.
Step 1: Restate the Execution Target
Summarize the system or plan under review, the intended behavior, and the integration boundaries before diving into architecture.
Review Dimensions
1. Architecture Diagram
Produce an ASCII diagram of the system. Components, data flow, external dependencies.
[Client] → [API] → [Service] → [DB]
→ [Queue] → [Worker]
2. Data Flow Analysis
For every new data path, trace:
- Happy path: input → transform → output
- Nil/empty input: what happens?
- Upstream error: what happens?
- Concurrent access: race conditions?
3. Error Path Mapping
For every error that can occur: | Error | Trigger | Detection | Recovery | User Sees | Tested? | |
Error Handling
| Scenario | Action | |----------|--------| | No target provided | Ask for clarification with examples | | Target not found | Search for alternatives, suggest closest match | | Agent dispatch fails | Fall back to manual execution, report the error | | Ambiguous input | Present options, ask user to pick | | Execution timeout | Save partial results, report what completed |
Guardrails
- Do not silently change scope or expand beyond the user request.
- Prefer concrete outputs and verification over abstract descriptions.
- Keep scope faithful to the user intent.
- Preserve existing workflow guardrails and stop conditions.
- Verify results before concluding. Run self-eval on output quality.
Related Skills
ShaheerKhawaja/writing-plans
tools
VerifiedTrustedCommunity
Implementation planning workflow that turns approved ideas into dependency-aware execution plans.
7SKILL.mdUpdated Apr 23, 2026
ShaheerKhawaja/wiki-rag
development
VerifiedTrustedCommunity
Local RAG and Graph RAG over the SecondBrain wiki vault. Progressive context loading (hot cache -> index -> domain -> entity). Graph traversal via wikilink resolution. Use when agents need cross-project context, when answering questions that span multiple domains, or when building context for planning tasks. Triggers on: "wiki context", "cross-project context", "what do we know about", "check the wiki", "graph context", "/wiki-rag".
7SKILL.mdUpdated Apr 23, 2026
ShaheerKhawaja/ux-genie
devops
VerifiedTrustedCommunity
UX improvement pipeline — creates user stories from UI guidelines, maps user journeys, identifies friction, dispatches fix agents. The user-experience equivalent of /production-upgrade.
7SKILL.mdUpdated Apr 23, 2026
ShaheerKhawaja/tdd
development
VerifiedTrustedCommunity
Test-driven development workflow that writes failing tests first, implements minimally, and refactors safely.
7SKILL.mdUpdated Apr 23, 2026