workflow-orientation

Audit project documentation and structure to create a compatible onboarding.md.

Updated Nov 8, 2025
One-click install
npx skills add https://github.com/berad217/human-training --skill workflow-orientation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-orientation
Source: https://github.com/berad217/human-training/tree/main/skills/workflow-orientation
Command: npx skills add https://github.com/berad217/human-training --skill workflow-orientation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adopting the structured sprint-based human-training workflow in an existing project often risks disrupting established documentation conventions, overwriting team-curated files, or forcing incompatible structural changes. This Skill eliminates that risk by first auditing the project read-only to understand its current state before proposing any changes.

Core Features & Use Cases

  • Read-Only State Detection: Classifies projects into 5 distinct states (empty, code with no workflow, partial setup, canonical healthy, mature divergent) without making any filesystem changes during the audit phase.
  • Non-Destructive Adaptation: For projects with existing conventions, creates a bridging onboarding.md that maps to the project's actual files instead of imposing canonical human-training structure, preserving team workflows.
  • Drift Checking for Healthy Projects: For projects already using the human-training workflow, runs automated checks for path resolution errors, stale DEVLOG entries, outdated handover docs, and missing template sections.
  • Use Case: You have a mature open source project with its own CONTRIBUTING.md, docs folder, and release notes process. This Skill will create an onboarding.md that points to your existing files instead of overwriting them, so you can adopt the human-training workflow without disrupting your team's existing processes.

Quick Start

Invoke the workflow-orientation skill in your project to have the AI audit its current workflow state and propose a tailored, non-destructive plan for adopting the sprint-based human-training process.

Frequently Asked Questions about workflow-orientation

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

FAQPage Schema
How do I adopt a sprint workflow in an existing project without overwriting documentation conventions?

To adopt a sprint workflow without overwriting conventions, the Skill audits your project read-only and generates a bridging onboarding.md that maps to your existing files, ensuring no team-curated documentation is disrupted.

What is the best way to check a healthy software project for sprint workflow drift?

Checking for sprint workflow drift involves running automated checks for path resolution errors, stale DEVLOG entries, outdated handover docs, and missing template sections to ensure canonical project health.

Can I add structured sprint workflow guardrails to a codebase that has no existing workflow setup?

Yes, you can add sprint workflow guardrails to a codebase with no setup by auditing the current project state and generating a tailored onboarding.md artifact to establish workflow rails.

Does the workflow onboarding process work for empty projects needing initial workflow rails?

The workflow onboarding process works for empty projects by detecting the empty state during a read-only audit and producing a compatible onboarding.md artifact to establish initial sprint-based collaboration guardrails.

How do mature open source projects with their own CONTRIBUTING.md files integrate with a structured sprint workflow?

Mature open source projects integrate by creating an onboarding.md that points to existing files like CONTRIBUTING.md instead of imposing canonical structure, preserving established release notes and documentation processes.

What are the limitations of non-destructive project onboarding generation?

The limitation of non-destructive onboarding generation is that it requires a read-only audit phase to classify the project state first, meaning no filesystem changes occur until a compatible onboarding.md artifact is proposed.