design-slice

Designs one vertical slice from a slice map and writes a per-slice design document.

730|137|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/juicesharp/rpiv-mono --skill design-slice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-slice
Source: https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-pi/skills/design-slice
Command: npx skills add https://github.com/juicesharp/rpiv-mono --skill design-slice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a large feature is decomposed into vertical slices, each slice still needs its own focused architecture design before implementation can begin. Doing this manually for every slice is slow and inconsistent, and doing it all at once produces shallow designs. This Skill designs exactly one slice in isolation, producing a structured design doc that downstream synthesis and implementation steps can consume.

Core Features & Use Cases

  • Single-slice design: Reads a slice map under .rpiv/artifacts/slices/, locates the named slice, and decides its approach, file map, key interfaces, integration points, and success criteria.
  • Upstream contract awareness: Accepts --upstream design docs from a design fanout and builds against their decided Key Interfaces instead of redesigning dependencies.
  • Structured output: Writes a frontmatter-tagged design doc to .rpiv/artifacts/designs/ with status tracking, consumed later by a synthesize step and graded by a review panel.
  • Use Case: A design fanout dispatches this Skill once per slice in parallel; each run reads only its slice's footing, asks the user only on genuine blocking design forks, and emits a ready-status design doc.

Quick Start

Run the design-slice skill with the path to your slice map and the slice identifier, for example ".rpiv/artifacts/slices/auth.md Slice 2: token refresh", to generate that slice's design document.

Frequently Asked Questions about design-slice

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design one vertical slice from a slice map?

Invoke the skill with the slice map path followed by the slice identifier, such as ".rpiv/artifacts/slices/feature.md Slice 2: title". It reads the slice's scope and footing, decides the architecture, and writes a design doc to .rpiv/artifacts/designs/.

What does the design-slice skill output?

It writes a markdown design document containing Approach, File Map, Key Interfaces, Integration Points, Success Criteria, and Notes sections, with frontmatter metadata including slice number, dependencies, and status set to ready.

Can I run design-slice standalone without a fanout?

It is designed as a fanout unit dispatched once per slice by a design workflow, not as a standalone tool. Upstream design docs are injected via the --upstream flag by the orchestrating fanout.

How does design-slice handle dependencies between slices?

Pass each direct dependency's design doc via repeated --upstream flags. The skill reads their Key Interfaces as fixed contracts and escalates to the user only if a needed contract is still an undecided fork in the upstream's Notes section.

When does design-slice ask the user questions?

It asks only when a genuine design fork blocks the slice and cannot be resolved from the slice map, upstream designs, research, or code. It never asks for approval of the finished design, since a grade panel owns that review.