archflow-init

Initializes Archflow project state files, stack settings, and design system configuration in a new project.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a phase-based AI development workflow requires creating many interlinked configuration files by hand, and missing or inconsistent files cause agents to fail mid-task. This Skill bootstraps the entire .archflow/ directory structure correctly in one guided pass. ## Core Features & Use Cases - Project State Bootstrap: Creates .archflow/current-phase.yaml and project-settings.yaml with phase tracking, ceremony mode, and gap tracking, plus copies phase, schema, stack, and design-system reference files without overwriting existing ones. - Guided Stack and Design System Selection: Offers stack profiles (e.g., NestJS + PostgreSQL + React, FastAPI, React Native) and a platform-filtered design system picker, writing the choices to YAML so every agent builds against the same contract. - Git and Agent Instruction Setup: Initializes git if needed, makes the initial commit, and injects an Archflow section into AGENTS.md/CLAUDE.md with update markers. - Use Case: A developer starting a new fullstack app runs the init command, picks the FastAPI + React profile and Material 3 design system, and immediately has a Phase 1-ready project where all 17 agents share consistent settings. ## Quick Start Ask your coding agent to run /archflow-init in the root of a new empty project to set up Archflow and start at Phase 1.

Frequently Asked Questions about archflow-init

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

FAQPage Schema
How do I set up Archflow in a new project?

Run /archflow-init from the project root. It creates the .archflow/ directory with current-phase.yaml and project-settings.yaml, copies phase and schema reference files, and starts the project at Phase 1 (Strategy & Planning).

How do I initialize Archflow for an existing codebase?

Do not use archflow-init for existing code. The command detects this case and redirects you to /archflow-onboard, the full onboarding wizard that analyzes your code and determines the correct starting phase via audit.

What happens if I run archflow-init twice?

The command is idempotent. If .archflow/current-phase.yaml already exists, it reports the current phase and project type, then exits without overwriting anything. File copies also skip any file the project already has.

Can I skip choosing a tech stack or design system during init?

Yes. Choosing "Decide later" writes an empty stack block, and agents will ask when they need a technology. If the design system is deferred, Phase 2 runs the picker before producing its first wireframe.

Does archflow-init require git?

Git is strongly recommended but not mandatory. The command checks for a git repository, offers to run git init, and warns if you decline. After setup it commits the .archflow/ files as the initial commit.