All skills
simota avatar

/nexus

@c805268
by shingo imotasimota/agent-skills85 stars
15

Orchestrating multi-specialist task chains and scope-adaptive product delivery: classifies intent, selects and executes the minimum viable chain, aggregates results, and verifies acceptance criteria. For multi-domain tasks, build-first delivery, and product lifecycle execution.

Use this Skill: https://skilld.dev/gh/simota/agent-skills/nexus

This session only. Nothing lands on disk.

referencedelivery-exit-criteria-validation.md

≈2.4k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Exit Criteria Auto-Validation

Purpose: Read this file when Nexus[deliver] validates a phase transition, applies pass thresholds, or uses simplified S/M validation and override rules.

Contents

  • Overview
  • Validation chains
  • Phase-specific validation checklists
  • Scoring and pass rules
  • Scope-adaptive validation
  • Validation overrides

Defines automated validation of phase exit criteria before Nexus[deliver] approves phase transitions.


Overview

Before any phase transition, Nexus[deliver] runs an automated validation chain to verify exit criteria are met. This prevents premature phase advancement and catches quality gaps early.

Phase work complete
  → Exit Criteria Validation
    → Pass (≥80%) → Next phase
    → Partial (60-79%) → Scope Reduction + proceed
    → Fail (<60%) → Anti-Stall activation

Validation Chains (Phase-Specific)

Each phase uses a tailored validation chain optimized for its artifact types. The universal Lens→Radar chain is replaced with phase-appropriate agents.

Phase Validation Chain Rationale
DISCOVER Lens → Field → Compete Validate research quality, persona completeness, competitive coverage
DEFINE Lens → Canon → Magi Validate specs against standards, decision quality
ARCHITECT Lens → Atlas → Schema Validate architecture integrity, dependency analysis, schema quality
BUILD Lens → Radar Validate code artifacts, test coverage, build health (default chain)
HARDEN Sentinel → Radar Validate security audit, test suite, quality gate
VALIDATE Voyager → Echo Validate E2E tests, UX persona review
LAUNCH Lens → Quill → Gear Validate docs, CI/CD pipeline, deployment readiness
GROW Growth → Pulse Validate SEO/CRO, analytics setup
EVOLVE Voice → Sweep Validate feedback collection, tech debt assessment

Chain Issuance

## NEXUS_AUTORUN_FULL
Task: Validate Phase [PHASE_NAME] exit criteria
Chain: [Phase-specific chain from table above]
Context: Phase [N] complete, verify exit criteria before transition
Acceptance: Validation report with per-criterion pass/fail and overall score

Phase-Specific Validation Checklists

DISCOVER Phase Exit

Criterion Validation Method Weight Pass Threshold
Product Definition exists Lens: file exists + >100 lines 0.30 File present
Target personas defined Lens: personas section present 0.25 ≥2 personas
Value proposition clear Lens: value prop section present 0.25 Non-empty
Constraints identified Lens: constraints listed 0.20 ≥1 constraint

DEFINE Phase Exit

Criterion Validation Method Weight Pass Threshold
Roadmap complete Lens: roadmap.md with features 0.25 ≥3 features
Feature specs written Lens: specs/ directory populated 0.25 All roadmap items
SUCCESS_CRITERIA defined Lens: measurable criteria 0.25 ≥3 criteria
KPIs specified Lens: tracking events listed 0.25 ≥2 KPIs

ARCHITECT Phase Exit

Criterion Validation Method Weight Pass Threshold
ADR documented Lens: adr/ files exist 0.25 ≥1 ADR
API spec defined Lens: API spec file exists 0.20 Endpoints listed
DB schema designed Lens: schema file exists 0.20 Tables/models defined
Repo structure defined Lens: directory layout 0.20 Structure documented
No circular deps Atlas: dependency analysis 0.15 Zero circular

BUILD Phase Exit

Criterion Validation Method Weight Pass Threshold
All features implemented Lens: source files per spec 0.25 All spec items
Tests passing Radar: test runner exit 0 0.30 100% pass
Build succeeds Radar: build command exit 0 0.25 Clean build
Basic coverage Radar: coverage report 0.20 ≥60%

HARDEN Phase Exit

Criterion Validation Method Weight Pass Threshold
Security audit pass Sentinel report: no critical 0.30 Zero critical
Performance targets met Bolt report: benchmarks 0.25 Within targets
All tests green Radar: full suite 0.20 100% pass

VALIDATE Phase Exit

Criterion Validation Method Weight Pass Threshold
E2E tests passing Voyager: E2E suite 0.30 ≥95% pass
UX validated Echo: persona review 0.25 No critical issues
Experiments configured Experiment: A/B setup 0.20 Config complete

LAUNCH Phase Exit

Criterion Validation Method Weight Pass Threshold
Documentation complete Lens: README + API docs 0.25 All sections
Release notes written Lens: CHANGELOG exists 0.20 Current version
CI/CD configured Gear: pipeline check 0.25 Pipeline runs
Demos created Lens: demo artifacts 0.15 ≥1 demo
Deployment ready Guardian: PR ready 0.15 PR created

GROW Phase Exit

Criterion Validation Method Weight Pass Threshold
SEO optimized Growth: meta audit 0.30 Core tags present
Analytics active Pulse: events firing 0.30 Key events tracked
Retention features Lens: features present 0.20 ≥1 feature
Growth experiments Experiment: setup 0.20 ≥1 experiment

EVOLVE Phase Exit

Criterion Validation Method Weight Pass Threshold
Feedback collected Voice: report exists 0.30 Actionable insights
Improvement plan Lens: plan document 0.30 Prioritized list
Tech debt assessed Sweep / Shift (detect/radar): report 0.20 Inventory complete
Next cycle input Lens: DISCOVER input ready 0.20 Personas + criteria updated

Scoring and Pass Rules

Score Calculation

phase_exit_score = Σ(criterion_pass × weight) / Σ(weight)

Each criterion scores: 1.0 (full pass), 0.5 (partial), 0.0 (fail).

Pass Thresholds

Score Verdict Action
≥0.80 PASS Proceed to next phase immediately
0.60–0.79 CONDITIONAL Scope Reduction: move failing criteria to next phase as Epics
<0.60 FAIL Anti-Stall activation (L1 retry the failing Epics)

Conditional Pass Handling

When score is 0.60–0.79:

  1. Identify failing criteria
  2. Create backlog Epics for each failing criterion
  3. Add Epics to the next phase's work queue (or current phase if revisiting)
  4. Log the conditional pass with gaps in NEXUS_DELIVERY_STATE
  5. Proceed to next phase

Fail Handling

When score <0.60:

  1. Identify which Epics produced insufficient artifacts
  2. Route to Anti-Stall L1 (retry those specific Epics)
  3. If L1 exhausted → L2 (scope reduction to accept lower bar)
  4. Re-run exit validation after recovery

Scope-Adaptive Validation

CRITICAL: Skipped phases have NO exit validation. Only phases that are actually executed require validation.

Phases Executed by Scope

Scope Validated Phases Skipped Phases (NO validation)
S BUILD, VALIDATE DISCOVER (inline), DEFINE, ARCHITECT, HARDEN, LAUNCH, GROW, EVOLVE
M BUILD, HARDEN, VALIDATE DISCOVER (inline), DEFINE, ARCHITECT, LAUNCH, GROW, EVOLVE
L DISCOVER, DEFINE, ARCHITECT, BUILD, HARDEN, VALIDATE, LAUNCH GROW, EVOLVE
XL All 9 phases None

Scope-Specific Validation Chains

Phase S scope M scope L scope XL scope
BUILD Radar (tests pass) Radar (tests + coverage) Lens → Radar Lens → Radar
HARDEN SKIP Sentinel → Radar Sentinel → Radar Full chain
VALIDATE Radar (final check) Radar (comprehensive) Voyager → Echo Full chain

S/M Scope Exit Criteria (Simplified)

S scope BUILD exit — Only 2 criteria:

Criterion Weight Pass
Tests passing 0.60 100% pass
Build succeeds 0.40 Clean build

M scope BUILD exit — 3 criteria:

Criterion Weight Pass
Tests passing 0.40 100% pass
Build succeeds 0.30 Clean build
Coverage adequate 0.30 ≥60%

M scope HARDEN exit — 2 criteria:

Criterion Weight Pass
No critical security issues 0.60 Sentinel: zero critical
Test coverage improved 0.40 ≥70%

Validation Overrides

In specific scenarios, validation thresholds can be relaxed:

Scenario Override Justification
S scope Only BUILD + VALIDATE validated; simplified criteria Small tools don't need full validation
M scope Only BUILD + HARDEN + VALIDATE validated; reduced criteria Medium features need security but not full ceremony
L4 Degradation active Accept partial pass (≥0.40) Graceful degradation mode
PHASED_REVIEW mode User approves despite score Explicit user override

Source: SKILL.md on GitHub

3 warnings13d5 checks · Risk MEDIUM
  • Gen Agent Trust Hub13d

    The 'nexus' skill is a comprehensive multi-agent orchestration framework that manages complex task chains. While it incorporates extensive internal guardrails and verification protocols, it explicitly mandates the use of high-risk flags that bypass security permissions to achieve autonomy. It also provides instructions for establishing persistent tasks via cron and GitHub Actions, and utilizes external research tools to fetch content from the web.

  • Socket13d

    1 alert: gptSecurity

  • Snyk13d

    Risk: LOW · No issues

  • Runlayer6mo

    6/22 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at c805268. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 2 weeks ago

README badge

README badge for simota/agent-skills/nexus