How feharo/software-foundation works
Software Foundation is a Python CLI and reusable SaaS starter for bootstrapping applications or adding engineering standards to existing projects. The main workflows are init to choose a backend and generate a starter, and adopt/audit/upgrade to inspect or update standards in an existing project. The graph preserves documented agent guidance and performance practices; implementation detail for the generators and upgrade flow is limited to the indexed references and README, so those links cite only that evidence.
Main entry points: foundation.py CLI entrypoint · new_saas.py SaaS generator · route.ts Workspace and task API · upgrade.py Catalog upgrade
Components 17
CLI workflows
- CLI entrypoint
scripts/foundation.py - Adoption and audit
scripts/foundation.py - SaaS generator
scripts/new_saas.py - Catalog upgrade
scripts/upgrade.py
Standards and guidance
- Performance catalog
standards/performance.json - Stack profiles
profiles - Agent skills
skills - Agent instructions
templates
SaaS starters
- PostgreSQL starter
blueprints/saas-nextjs-postgres - Supabase starter
blueprints/saas-nextjs-supabase - Better Auth
blueprints/saas-nextjs-postgres/lib/auth.ts - Workspace and tasks
blueprints/saas-nextjs-postgres/app/dashboard/dashboard-client.tsx - Workspace and task API
blueprints/saas-nextjs-postgres/app/api/tasks/route.ts - PostgreSQL pool
blueprints/saas-nextjs-postgres/lib/db.ts - Supabase dashboard
blueprints/saas-nextjs-supabase/app/dashboard/page.tsx - Supabase client
blueprints/saas-nextjs-supabase/lib/supabase.ts
Other components
- Developer
Connections 16
- Developer → CLI entrypoint: runs commands
README.md - CLI entrypoint → SaaS generator: dispatches init
scripts/foundation.py - CLI entrypoint → Catalog upgrade: dispatches upgrade
scripts/foundation.py - CLI entrypoint → Adoption and audit: runs adopt or audit
README.md - Adoption and audit → Stack profiles: selects profile
scripts/foundation.py - Adoption and audit → Performance catalog: checks practices
README.md - Adoption and audit → Agent instructions: plans instructions
scripts/foundation.py - Catalog upgrade → Performance catalog: updates catalog
README.md - SaaS generator → PostgreSQL starter: generates PostgreSQL
README.md - SaaS generator → Supabase starter: generates Supabase
README.md - Developer → Agent skills: uses guidance
README.md - Workspace and tasks → Workspace and task API: calls API
blueprints/saas-nextjs-postgres/app/dashboard/dashboard-client.tsx - Workspace and task API → PostgreSQL pool: queries database
blueprints/saas-nextjs-postgres/app/api/tasks/route.ts - Workspace and task API → Better Auth: resolves identity
blueprints/saas-nextjs-postgres/app/api/tasks/route.ts - Better Auth → PostgreSQL pool: uses pool
blueprints/saas-nextjs-postgres/lib/auth.ts - Supabase dashboard → Supabase client: uses client
blueprints/saas-nextjs-supabase/app/dashboard/page.tsx