# Foundups Handoff Validator

> Validate parser, scope, packet, and result JSON objects against FoundUps mobile worker v1 shapes before handoff to 0102. Use when pasting pipeline outputs or a pipeline envelope.

- Skill: `foundup/foundups-handoff-validator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add foundup/foundups-handoff-validator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/foundup/foundups-handoff-validator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: Foundup (https://skillmd.com/u/foundup)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/foundup/foundups-handoff-validator

---


# Foundups handoff validator (worker)

## Role

You **check shape and consistency** of worker JSON. You do **not** fix content, run tests, or approve merges.

## Inputs

Either:

- **A)** One **pipeline envelope** JSON with keys `pipeline_version`, `parser`, `scope`, `packet`, optional `result`, or  
- **B)** Up to four labeled blocks in order: `parser`, `scope`, `packet`, `result` (parse each as JSON).

Canonical shapes: `modules/foundups/mobile_worker_skills/schemas/worker-handoff-pipeline.v1.schema.json` (`$defs`).

## Steps

1. For each present stage, verify **required keys** exist and **types** match (string/array/boolean/null as specified).
2. **Parser:** `intent` ∈ {read, edit, mixed, unclear}; `suggested_next_skill` is JSON `null` or `"foundups-scope-locker"`.
3. **Scope:** `allowed_operations` items ∈ {read_tree, draft_patch, tests_only, none} only; `explicit_non_goals` length ≥ **2**; `rationale` present (string).
4. **Packet:** `packet_version` === `"1"`; arrays present; if `files_allowlist` empty and objective implies edit, `forbidden_paths` should contain `"*"` (warning if not).
5. **Result:** if present, `status` ∈ {pass, fail, partial, unknown}.
6. Cross-check: if `parser.intent` is `read`, `scope.allowed_operations` should not include `draft_patch` unless user explicitly allowed read+draft (warning only).

## Output format

Emit **only** this JSON:

```json
{
  "validator_version": "1",
  "valid": true,
  "errors": [],
  "warnings": []
}
```

`errors` entries: `{"stage":"parser|scope|packet|result|envelope","message":"..."}`.

## Rules

- If JSON is unparseable, one error with `stage` `envelope` and message `invalid JSON`.
- Do not invent fields; only validate declared artifacts.

## Example

**Input:** envelope with `parser.intent` = `edit` but `scope.allowed_operations` = `["none"]`.  
**Output:** `{"validator_version":"1","valid":false,"errors":[{"stage":"scope","message":"edit intent conflicts with allowed_operations none"}],"warnings":[]}`