pev-architect

Read cycle manifests and draft scope and problem statements for architectural planning.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ddpoe/pev-agent-nexus --skill pev-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pev-architect
Source: https://github.com/ddpoe/pev-agent-nexus/tree/main/plugins/pev/skills/pev-architect
Command: npx skills add https://github.com/ddpoe/pev-agent-nexus --skill pev-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill provides a structured methodology for planning and framing architectural work within a cycle, guiding exploration, boundary setting, and pitch creation to align the Builder and Auditor.

Core Features & Use Cases

  • Read cycle manifest and assess scope quickly to establish a clear problem statement.
  • Conduct targeted, high-level exploration of codebase interfaces to bound work without diving into implementation details.
  • Draft a Shape Up–style cycle pitch and an early scope/problem write-up for the cycle manifest, enabling rapid alignment and execution.
  • Facilitate NEEDS_INPUT conversations to gather user direction while preserving context across rounds.

Quick Start

Provide the cycle manifest doc ID and the user request, and I will read the manifest to outline the initial scope and problem framing.

Frequently Asked Questions about pev-architect

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

FAQPage Schema
How do I draft an architectural scope and problem statement for a new development cycle?

Draft an architectural scope by reading the cycle manifest, exploring high-level codebase interfaces, and bounding work at the module level. This produces an early scope and problem write-up that aligns the Builder and Auditor for rapid execution.

What is the best way to structure a Shape Up–style cycle pitch for software engineering planning?

Structure a Shape Up–style cycle pitch by outlining the problem, solution sketch, constraints, and module-level boundaries. This approach frames the architectural work and establishes clear scope to guide engagement, user stories, and task generation.

How do I explore a codebase to set architectural boundaries without diving into implementation details?

Explore a codebase for architectural boundaries by conducting targeted, high-level exploration of codebase interfaces. This bounds the work effectively by assessing module-level boundaries rather than per-function changes, keeping the focus on structural scope.

Can I iteratively update a cycle manifest across planning rounds when scope changes?

Iteratively update a cycle manifest across rounds by preserving context and supporting NEEDS_INPUT interactions. This allows you to gather user direction, refine the problem framing, and maintain alignment throughout the planning phase workflow.

Does architectural planning for a cycle require per-function change assessments?

Architectural planning for a cycle does not require per-function change assessments. It emphasizes module-level boundaries and high-level interface exploration to bound work, deliberately avoiding implementation details to maintain structural focus.

What prerequisites are needed to start architectural cycle planning and scope assessment?

Prerequisites for architectural cycle planning include providing a cycle manifest document ID and the user request. The Skill reads the manifest to outline initial scope, requiring no additional dependencies or component installations to begin framing work.