The /arckit.start command provides a guided onboarding and navigation experience for ArcKit. It analyzes your current project state and recommends the best next steps.
This is a slash command (not a CLI command). Run it from within your AI assistant after initializing your project with arckit init.
# General onboarding (shows full decision tree)/arckit.start# Focus on specific workflow area/arckit.start new project/arckit.start procurement/arckit.start governance review
Connected Tools---------------β AWS Knowledge β AWS service research and architecture patternsβ Microsoft Learn β Azure and Microsoft documentationβ Google Developer β not connected (GCP research available via web search fallback)
This section only appears if at least one cloud research MCP is detected.
Based on your project state, provides 3-5 specific next steps:Example for empty project:
Suggested next steps--------------------1. Run /arckit.principles to establish architecture principles (required by most commands)2. Run /arckit.stakeholders to analyze stakeholder drivers and goals3. Run /arckit.requirements to create your requirements specification
Example for 50% complete project:
Suggested next steps--------------------1. Run /arckit.sow to generate vendor RFP (requirements are complete)2. Run /arckit.evaluate to create vendor evaluation framework3. Run /arckit.hld-review to prepare for design gate
How can I help today?1. "I'm starting a new project" β I'll guide you through init β principles β stakeholders β requirements2. "I need to make an architecture decision" β I'll help with research, ADRs, and design reviews3. "I want to review existing work" β I'll run health checks, governance analysis, and compliance scans
After this prompt, the assistant waits for your response and begins the selected workflow.
ArcKit β Enterprise Architecture Governance ToolkitVersion 0.11.5 | 54 commands | Plugin modeYour AI-powered assistant for architecture governance, vendor procurement,and compliance β all driven by templates and traceability.Projects--------No project structure found. Run /arckit.init to create your first project.What are you working on?Starting a new projectβββ No project structure? β /arckit.initβββ Need principles first? β /arckit.principles (global, required by most commands)βββ Planning phases & gates? β /arckit.planβββ Ready to scope? β /arckit.stakeholders β /arckit.requirements[... full decision tree ...]Suggested next steps--------------------1. Run /arckit.init to create your project structure2. Run /arckit.principles to establish architecture principles3. Run /arckit.plan to create your project timelineHow can I help today?1. "I'm starting a new project" β I'll guide you through init β principles β stakeholders β requirements2. "I need to make an architecture decision" β I'll help with research, ADRs, and design reviews3. "I want to review existing work" β I'll run health checks, governance analysis, and compliance scans
No project structure found. Run /arckit.init to create your first project.
Cause: The projects/ directory does not exist or is empty.Solution: Run /arckit.plan or manually create a project directory:
mkdir -p projects/001-my-project
ArcKit version not showing
Symptom: Version shows as βunknownβ or is missing.Cause: The VERSION file is missing from the project root.Solution: Run arckit init again to refresh project files:
arckit init --here --ai codex
MCP tools not detected
Symptom: βConnected Toolsβ section is missing.Cause: No MCP servers are configured or connected.Solution: This is normal. The section only appears if at least one cloud research MCP is available. To enable: