Expecho/Agent42 / .claude/skills/add-aspire
add-aspire
VerifiedAdd Aspire (AppHost + ServiceDefaults orchestration) to this repo - checks/installs the Aspire CLI, scaffolds via aspire init or aspire new, verifies the AppHost runs, and updates CLAUDE.md commands. Aspire is polyglot (.NET, Node.js, Python, Go officially; Java/Rust/PowerShell via community toolkit). Invoked from onboarding when the user opts in, or directly at any time.
Add Aspire to this repo
Aspire is polyglot — the AppHost can be C# or TypeScript, orchestrating .NET, Node.js, Python, and Go apps (official) plus Java, Rust, and PowerShell (community toolkit), alongside containers, databases, caches, and queues. See https://aspire.dev/languages-and-runtimes/ for the current matrix — check it rather than assuming a stack is unsupported.
Step 1 — CLI preflight
- Run
aspire -v. It prints the installed version; report it. - If the command fails (not installed), install the CLI:
npm install -g @microsoft/aspire-cli(checknpm -vexists first; if there is no Node on the machine, ask the user how they want to install the Aspire CLI instead of guessing). Re-runaspire -vto confirm and report the version. - Scaffold ONLY through the CLI — never hand-write AppHost/ServiceDefaults files from memory. The CLI resolves current template + package versions, which is exactly hard rule 4 (versions are resolved, never recalled).
Step 2 — Scaffold
- AppHost language: C# for .NET-centric repos, TypeScript for Node.js/frontend workspaces. Mixed repo → ask the user which the team prefers to maintain.
- Existing apps/services:
aspire initfrom the repo root — wires an AppHost (+ ServiceDefaults for .NET) around what exists. Register each app with the matching resource type (project resources for .NET; npm/Python/Go app resources for the rest) — existing apps are orchestrated as-is, never rewritten. - Greenfield (no code yet):
aspire newand pick the template matching the stack decided at onboarding. - Integrations (database, cache, queue — detected or planned): add them with
aspire add <integration>, not by hand-adding packages.
Step 3 — Verify
- The repo's build must still pass (
dotnet build,npm run build,go build— whatever the stack's Commands table says). aspire run— confirm the AppHost starts, the dashboard URL appears, and each registered app shows up as a resource; then stop it. Do not report success on a scaffold that was never run.
Step 4 — Record
- CLAUDE.md Commands table: set Run dev to
aspire run(only after the verify step above proved it works). - Outside onboarding, record the orchestration decision via
/decide(alternatives: docker-compose, manual multi-app launch scripts). - New canonical shape (e.g. how a service registers with the AppHost)? Apply the
/gotchaadmission test before adding an exemplar row.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |