---
name: system-review-d3953a59d426
description: |
  Run a system review to check project health.
  Use when issues drop below 5, an EPIC closes, or 7+ days since last review.
  Triggers on "system review", "project health", "review system".
allowed-tools: Read, Edit, Write, Bash, Grep, Glob, Task, WebSearch
---

# System Review Skill

## Trigger Conditions

Run when ANY occur:

- Open GitHub issues drop below 5
- An EPIC issue is closed (label: `epic`)
- 7 days since last review
- Manual request

## Review Checklist

### Phase 1: Registry Reconciliation

```bash
# Count techniques by status
grep -c "status: implemented" docs/research/registry/techniques.yaml
grep -c "status: planned" docs/research/registry/techniques.yaml

# Verify RESEARCH_INDEX.md matches actual counts
# Check integration_files exist for implemented techniques
```

### Phase 2: Documentation Sync

- [ ] ARCHITECTURE.md reflects current phase status
- [ ] README.md lists current capabilities accurately
- [ ] CHANGELOG.md has entries for shipped features
- [ ] ALIGNMENT_ROADMAP.md phase status is current

### Phase 3: Issue Health

```bash
gh issue list --state open --limit 50
```

- [ ] No orphaned issues (referenced but not in GitHub)
- [ ] No stale issues (no activity > 30 days without `wontfix` label)
- [ ] Labels are accurate and consistent

### Phase 4: Generate Report

Create GitHub issue titled "System Review: YYYY-MM-DD" with findings and action items.

```bash
TZ='America/New_York' date '+%Y-%m-%d'
gh issue create --title "System Review: $(TZ='America/New_York' date '+%Y-%m-%d')" \
  --label "maintenance" --body "## Findings\n\n[report here]"
```

## Anti-rationalization — System review

| Excuse                                             | Counter                                                                                                                                |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| "Skip the review, I just looked at this last week" | A week is enough for new alerts, dep advisories, and CI flakes. Run all phases.                                                        |
| "No new issues, the review is wasted time"         | The review's value isn't in finding new issues — it's in confirming the system isn't drifting silently. Empty reviews are good signal. |
| "I'll skip Phase X, it's never useful"             | If a phase is never useful, file an issue to remove it. Don't silently skip — the next reviewer will skip a different phase.           |

## Red flags

- Phase X "passed" with no evidence captured (dates, alert counts, CI status)
- Stale-issue review missed an issue >90 days old
- New CodeQL alert appeared but not triaged in the review
- Review issue created but never closed (review work lingers)

## Verification checklist

- [ ] Each phase ran; outcome recorded in the review issue
- [ ] Stale-issue check covered all open issues > 90 days
- [ ] CodeQL/Scorecard/dependabot alert counts captured
- [ ] CI health check (last 5 runs on main green)
- [ ] Review issue closed with summary


---
Source attribution: nexus-substrate
Original project: https://github.com/nexus-substrate/nexus-agents/blob/ddc209542969af8515e8424e45f93905e445d81c/skills/system-review/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 William Zujkowski

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.


## Additional upstream notices

system-review-d3953a59d426/DAVEAI-UPSTREAM-NOTICE

nexus-agents
Copyright (c) 2026 William Zujkowski

This project is inspired by and incorporates concepts from claude-team-mcp,
which is also licensed under the MIT License. Attribution is preserved per
the terms of the original license.


# Mega AI Hub resource metadata

Creator / publisher: nexus-substrate
Original project: https://github.com/nexus-substrate/nexus-agents/blob/ddc209542969af8515e8424e45f93905e445d81c/skills/system-review/SKILL.md
Attribution basis: Source repository record

Fields of work: Operations, Product Management, Project & Program Management
Roles: Operations Manager, Project Manager, Technical Product Manager
Specialties: API, Cross Platform, Testing
Tools: GitHub
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 2536c72580fc18702ac5b0d7e64795cf0ffced571d8f997469dd640300fe5ce5