core-guided-user-workflow

Summarize repository state and recommend next steps across project phases.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill core-guided-user-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-guided-user-workflow
Source: https://github.com/FernanSuoza/AIDD-project-bootstrap/tree/main/templates/skills/core-guided-user-workflow
Command: npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill core-guided-user-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml.

What problem does it solve?

Teams and individual contributors often get stuck or lose momentum because repository state, pending review gates, and next actionable steps are not presented in a concise, phase-aware way. This Skill reduces friction by summarizing current state, highlighting missing prerequisites and review packets, and recommending a single clear next action with alternatives and consequences.

Core Features & Use Cases

  • Phase-aware summaries that adapt guidance for onboarding, architecture, planning, implementation, verification, and release.
  • Review gate detection and review-packet handoff guidance to enforce mandatory human-in-the-loop decisions.
  • Concise next-step recommendations, alternatives, and consequence explanations, including Git-aware delivery advice when implementation work is active.
  • Use case: A journey coordinator asks for the current project phase and changed artifacts to produce a short guidance block that the team can act on immediately.

Quick Start

Ask the assistant to run the core-guided-user-workflow skill with the active phase and changed artifact list to receive a concise current-state summary and a recommended next step.

Frequently Asked Questions about core-guided-user-workflow

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

FAQPage Schema
How do I get next-step recommendations for my current project phase?

Phase-aware guidance summarizes your repository state and review gates to recommend concrete next steps. It reads execution-plan project state files to produce concise recommendations, review packets, and decision options for your current phase.

How do I track review gates and pending decisions during project onboarding?

Review gate detection reads execution-plan state files to surface mandatory human-in-the-loop decisions. It generates review packets and handoff instructions that highlight unresolved choices and pending approvals across onboarding, architecture, and implementation phases.

What is the best way to summarize repository state for a human-in-the-loop team?

Phase-aware summaries adapt to onboarding, architecture, planning, implementation, verification, and release phases. They validate required setup choices and produce a concise current-state summary with a recommended next step, alternatives, and consequence explanations.

How do I generate a review packet for pending execution-plan artifacts?

Review packets are generated by reading execution-plan project state and review gate files, validating required setup choices, and producing decision options that reference execution-plan artifacts for human-in-the-loop team handoff.

Does this workflow guidance require specific execution-plan files to function?

Yes, it requires execution-plan project state and review gate files to function. The Skill reads these artifacts to validate setup choices and generate next-step recommendations, review packets, and decision options across all project phases.

When should I use phase-aware workflow guidance instead of manual project state tracking?

Use phase-aware workflow guidance when teams lose momentum because repository state and pending review gates are not presented concisely. It reduces friction by summarizing current state, highlighting missing prerequisites, and recommending a single clear next action with consequences.