Python 3.6+ · zero external dependencies

Scaffold your DevOps & quality stack in one command.

SeedScaffold is a composable toolchain that generates the infrastructure every service needs — API docs, CI/CD, monitoring, test suites, database migrations — from a single unified CLI. Standard library only. No install footprint.

✓ Unified skill CLI ✓ 4 built-in presets ✓ Composable generators ✓ MIT licensed
bash — seedscaffold Copy
# scaffold the full toolchain into an existing service
skill run --preset full-stack \
  --project /data/projects/m9410_UserService \
  --service-name "UserService" --service-port 9410

✓ api-docs      OpenAPI spec + Swagger UI
✓ cicd          GitHub Actions / GitLab CI + Dockerfile
✓ monitoring    Prometheus + Grafana dashboards
✓ testing       Jest / Playwright test suite
✓ database      migrations + ORM models
✓ performance   profiling dashboard
✓ quality       code-quality report
The skill library

Every generator is a self-contained skill.

Run a skill on its own or compose several through a preset. Each one inspects your project and writes ready-to-use configuration — no boilerplate to hand-copy.

📄

API doc generator

Produces an OpenAPI specification and a browsable Swagger UI site for your services.

skill add api-docs
🚀

Deployment pipeline

Generates CI/CD configuration for GitHub Actions or GitLab CI, plus Dockerfile and k8s manifests.

skill add cicd
📈

Monitoring dashboard

Creates a Prometheus + Grafana monitoring setup wired to the services you name.

skill add monitoring
🧪

Test suite generator

Scaffolds a Jest or Playwright test framework so new projects start with a testing baseline.

skill add testing
🗃

Database migrations

Generates migration scripts and ORM models for your chosen database and ORM.

skill add database
📦

Project template manager

Capture a project as a reusable template, then apply it to spin up new services.

skill template
⚡

Performance analyzer

Builds a performance-analysis dashboard for the services under review.

skill add performance
🔍

Code quality analyzer

Runs code-quality checks and produces a report you can drop into review.

skill add quality

These eight are the production tool skills wired into the built-in presets. The repository also carries additional experimental generators; run skill list to see what is installed in your copy.

Presets

Batch the right skills for the job.

A preset is an ordered bundle of skills. Pick one instead of chaining commands by hand — or copy a preset JSON and tailor your own.

full-stack
The complete toolchain — all eight production skills, in order.
api-docscicdmonitoringtestingdatabasetemplateperformancequality
minimal
Three core skills to get a new project moving quickly.
cicdtestingapi-docs
devops
CI/CD, monitoring and performance for operational hardening.
cicdmonitoringperformanceapi-docs
quality
Testing, code quality and performance in one pass.
testingqualityperformance
Quickstart

From clone to scaffold in five minutes.

No package to install — SeedScaffold runs on the Python standard library. Alias the CLI and go.

bash Copy
# 1. set up the CLI alias
cd /data/projects/m488_SeedScaffold
alias skill='python3 skill_cli.py'

# 2. see what is available
skill list
skill presets

# 3. initialize a new project on a chosen port
skill init my-new-project --port 9500

# 4. add a single skill to an existing project
skill add api-docs --project /data/projects/m9410_UserService

# 5. or run a whole preset at once
skill run --preset minimal --project /data/projects/m9410_UserService

Prefer a global command? Symlink skill_cli.py onto your PATH. Every skill also runs standalone via python3 skills/<name>_skill.py --help.

Where it fits

Built for teams standing up many services.

01

New microservice

Run the full-stack preset the moment a service is created so it ships with docs, pipelines, monitoring and tests from day one.

02

Retrofitting an existing project

Point the devops or quality preset at a running project to backfill the operational infrastructure it never got.

03

Standardizing a fleet

Capture a reference project as a template, then apply it across services so every repo follows the same conventions.

How it works

One base class, consistent behavior everywhere.

Every skill inherits the same integration base, so the CLI, parameters and output layout stay predictable as the library grows.

01

Point at a project

Pass a project path, service name and port. The skill reads what is there.

02

Generate config

Each skill writes ready-to-use configuration and artifacts into place.

03

Compose with presets

Presets run skills in a defined order, skipping steps that lack params.

04

Extend it

Copy the integration template, subclass, and add your own skill.

Stop hand-wiring the same infrastructure.

Alias the CLI, run a preset, and let SeedScaffold generate the scaffolding for you.