Template

Files

lmiranda 2d51df7a42 feat(marketplace): command consolidation + 8 new plugins (v8.1.0 → v9.0.0) [BREAKING]

Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action>
sub-command pattern. Git-flow consolidated from 8→5 commands (commit
variants absorbed into --push/--merge/--sync flags). Dispatch files,
name: frontmatter, and cross-reference updates for all plugins.

Phase 2: Design documents for 8 new plugins in docs/designs/.

Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate,
saas-react-platform, saas-test-pilot, data-seed, ops-release-manager,
ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents,
skills, README, and claude-md-integration. Marketplace grows from 12→20.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-06 14:52:11 -05:00

2.7 KiB

Raw Blame History

name, description, agent

name	description	agent
api setup	Setup wizard for saas-api-platform	api-architect

/api setup - API Platform Setup Wizard

Skills to Load

skills/framework-detection.md
skills/visual-header.md

Visual Output

Display header: API-PLATFORM - Setup Wizard

Usage

/api setup

Workflow

Phase 1: Framework Detection

Scan the project root for framework indicators:

File / Pattern	Framework	Confidence
`main.py` with `from fastapi`	FastAPI	High
`app.py` with `from fastapi`	FastAPI	High
`requirements.txt` containing `fastapi`	FastAPI	Medium
`pyproject.toml` with `fastapi` dependency	FastAPI	Medium
`package.json` with `express` dependency	Express	High
`app.js` or `app.ts` with `require('express')`	Express	High
`tsconfig.json` + express in deps	Express (TypeScript)	High

If no framework detected, ask user to select one.

Phase 2: Project Structure Mapping

Identify existing project layout:

Route files: Locate route/controller directories
Models: Locate model/schema definition files
Middleware: Locate existing middleware
Tests: Locate test directories and test runner config
OpenAPI spec: Check for existing openapi.yaml, openapi.json, or swagger.json

Report findings to user with directory tree.

Phase 3: Convention Configuration

Ask user about project conventions:

Route style: RESTful nested (/users/{id}/posts) vs flat (/user-posts)
Versioning: URL prefix (/v1/) vs header-based vs none
Auth pattern: JWT, OAuth2, API key, or none
Response format: JSON:API, HAL, plain JSON

Store decisions in .api-platform.json in project root for future commands.

Phase 4: Validation

Verify detected configuration:

Confirm framework version
Confirm route directory location
Confirm model directory location
Display summary with all detected settings

Output Format

+----------------------------------------------------------------------+
|  API-PLATFORM - Setup Wizard                                         |
+----------------------------------------------------------------------+

Framework:     FastAPI 0.104.1
Route Dir:     ./app/routes/
Models Dir:    ./app/models/
Tests Dir:     ./tests/
OpenAPI Spec:  ./openapi.yaml (existing)

Conventions:
  Versioning:  /v1/ URL prefix
  Auth:        JWT Bearer
  Response:    Plain JSON

Configuration saved to .api-platform.json

Important Notes

This command does NOT create project files; it only detects and configures
If .api-platform.json already exists, offer to update or keep existing
All subsequent commands rely on setup configuration

2.7 KiB Raw Blame History