archflow-onboard

Onboards existing codebases into the Archflow phase-based development framework through a three-phase wizard.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-onboard-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-onboard
Source: https://github.com/AZidan/archflow/tree/main/adapters/copilot/.github/skills/archflow-onboard
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-onboard-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adopting a structured AI development workflow on an existing codebase is hard: the agent has no context about your stack, roadmap, design system, or API contracts, and sessions lose that context. This Skill audits the codebase, imports external project context, and generates the artifacts Archflow agents need to work coherently. ## Core Features & Use Cases - Codebase Audit & Stack Detection: Scans the repository to detect project type (fullstack, frontend-only, backend-only, mobile), frameworks, tests, and CI/CD, then validates or backfills the .archflow/ template files. - Context Import: Pulls strategy and roadmap material from Jira, Notion, Linear, GitHub Issues, Confluence, and other sources via MCP, with untrusted-content isolation rules. - Agent-Orchestrated Artifact Generation: Dispatches specialized agents (product-strategist, ux-designer, api-contract-architect, feature-planner) to produce project context, roadmap, design system, wireframes, and API contracts. - Use Case: You inherit a React/Node codebase with no documentation. Run the wizard to audit the code, import the Notion roadmap, generate an OpenAPI contract from existing routes, and land on the correct Archflow phase with a reconciled v2.0 roadmap. ## Quick Start Ask your coding agent to run /archflow-onboard from the project root to audit the existing codebase and set up Archflow.

Frequently Asked Questions about archflow-onboard

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

FAQPage Schema
How do I onboard an existing codebase to Archflow?

Run /archflow-onboard from the project root. The wizard detects your stack, collects context sources and design preferences, dispatches analysis agents, and generates the .archflow/ artifacts including roadmap, project context, and API contract.

What project types does Archflow onboarding support?

It supports fullstack, frontend_only, backend_only, and mobile projects. Detection runs automatically from package manifests and source files, and phases, agents, and artifacts adapt to the detected type.

Can Archflow import a roadmap from Jira or Notion?

Yes. The wizard imports context from Jira, Notion, Linear, GitHub Issues, Confluence, Google Drive, Trello, and Slack via MCP connections, or from local files and conversational input. Fetched content is wrapped as untrusted data before analysis.

What happens if the onboarding wizard is interrupted?

Progress is saved to .onboard-progress.yaml after each step. Re-running /archflow-onboard resumes from the saved wizard phase, re-asking incomplete questions or re-dispatching only the agents that did not finish.

Does onboarding work with an existing v1.0 Archflow roadmap?

No. Onboarding detects a v1.0 roadmap and stops, directing you to run /archflow-migrate first to upgrade to the v2.0 split-file format. It validates and auto-fixes only v2.0 roadmaps.