architecture-workflow

Solid

Recommends which /arckit:* commands to run, and in what order, for a new or in-flight architecture project, from a short triage of sector, project type, current stage and timeline. Backs /arckit:start. Not needed when the user has already named the command they want, or is asking about the content of an artefact rather than the sequence.

AI & Automation 2,219 stars 279 forks Updated 1 weeks ago NOASSERTION

Install

View on GitHub

Quality Score: 86/100

Stars 20%
100
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Architecture Workflow Guides users through project onboarding using adaptive-depth questions and recommends a tailored command sequence. <HARD-GATE> Do NOT run any `/arckit:*` commands during this process. Your only output is a recommended command plan. The user decides when and what to execute. This applies regardless of how simple the project seems. </HARD-GATE> ## Anti-Patterns ### "I already know what I need" Even experienced architects benefit from the triage. It catches blind spots — missing compliance requirements, forgotten dependencies, stakeholder gaps. The triage is fast (3-4 questions). Skip it and you risk generating artifacts in the wrong order or missing mandatory prerequisites. ### "Just run everything" A 30-command sequence helps nobody. The skill's job is to recommend the *right* commands for *this* project, in the *right* order. Every project is different — a compliance review needs 6 commands, not 30. ## Process Follow these steps in order. Ask questions one at a time using AskUserQuestion. Prefer multiple-choice options. ### Step 1: Detect Project State Automatically check the project context (no questions needed): - Check if `projects/` directory exists and count projects - Check for principles document (`ARC-000-PRIN-*`) - Count existing artifacts per project - Use ArcKit Project Context from the SessionStart hook if available Based on findings, determine: - **New project**: No `projects/` directory or empty — recommend starting from scr...

Details

Author
tractorjuice
Repository
tractorjuice/arc-kit
Created
11 months ago
Last Updated
1 weeks ago
Language
JavaScript
License
NOASSERTION

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

architecture-workflow

This skill should be used when the user is starting an architecture project or asking what to run next. Load whenever the task sounds like 'I'm starting a new project', 'guide me through', 'what command should I run', 'what comes next', 'how do I begin', 'help me get started', 'which /arckit:* in what order', 'set up a new project', 'new system build', or 'where do I start'. Recommends a tailored command sequence based on sector, project type, current stage, and timeline.

2 Updated 1 months ago
tractorjuice
AI & Automation Listed

ami-architect-project

Interactively sets up the initial architecture of a new project. It gathers requirements, researches technologies, proposes a stack and folder structure with constant user interaction, and finally scaffolds the initial files and a comprehensive README.md.

0 Updated 5 days ago
AnaCataVC
AI & Automation Listed

arch-health

Proactive whole-codebase architecture scan — find shallow modules, leaky interfaces, misplaced seams, layer violations, and ball-of-mud hotspots; present them as a RANKED report; then grill through the one you pick and route it to /refactor or /prepare. Run it every few days to keep entropy in check, before the codebase becomes hard to change. Distinct from /refactor (cleans the current diff on demand) — this scans the whole tree and surfaces what to clean. TRIGGER when: the user wants an architecture health-check, "what's rotting here", "find the worst modules", "where's the tech debt", a periodic ball-of-mud scan, or deepening opportunities. DO NOT TRIGGER when: the user wants to clean up specific changed files (use /refactor), review a diff for bugs (use /code-review), or plan one known change (use /prepare).

2 Updated 1 weeks ago
mik2win