Domain-driven infrastructure automation with elegant ROI tracking. 5 outcome pack templates plus business intelligence for measuring project value and justifying investments.
npm install quallaa-cli> Domain Engineering infrastructure for AI-assisted development - Ship outcomes, not code
``bashInstall the CLI
npm i -g quallaa-cli
This generates a production-ready project with business workflow scaffolding, JSON schema data contracts, API integrations, gold datasets for testing, and evaluation harnesses measuring accuracy, efficiency, and cost.
šÆ What is Quallaa CLI?
Quallaa CLI helps domain experts (founders, product managers, marketers, operations managers) ship production-ready business outcomes using AI-assisted development. Instead of starting with a blank canvas, you get:
- šļø 5 Outcome Templates: Pre-built workflows for professional services, nonprofits, e-commerce, CRM, and financial operations
- š¤ AI Context: Rich CLAUDE.md files that give AI assistants deep understanding of your domain
- š Evaluation Harness: Measure what matters - accuracy, rework, time, and cost
- š Security Built-in: Secrets auditing, credential rotation reminders, secure storage
- ā” Two Architectures: Choose between full web apps or headless workers
š¦ Outcome Pack Templates
$3
Professional Services Billing Automation
bash
quallaa outcome --template project-invoice-guardrails
`
Generates complete time-to-cash workflow:
/contracts # TimeEntry, Project, SOW, Invoice, RevRecPolicy schemas
/integrations # Harvest time tracking, QuickBooks Online connectors
/jobs # Time ingestion, invoice generation, revenue recognition
/evaluators # Billing accuracy, realization rates, ASC 606 compliance
/gold-data # Sample projects, invoices, time entries for testing
Perfect for: Consultancies, agencies, law firms, professional services$3
Nonprofit Management & Compliance
bash
quallaa outcome --template donor-member-rollups
`
Generates comprehensive nonprofit operations:
/contracts # Donation, Member, Fund, JournalEntry schemas
/integrations # Stripe payments, NeonCRM, QuickBooks connectors
/jobs # Donation processing, membership renewals, fund tracking
/evaluators # Donation conversion, member retention, compliance metrics
/gold-data # Sample donors, campaigns, restricted funds for testing
Perfect for: Nonprofits, foundations, membership organizations$3
E-commerce Multi-Channel Operations
bash
quallaa outcome --template inventory-pricing-sync
`
Generates unified commerce operations:
/contracts # SKU, Inventory, Price schemas with multi-channel support
/integrations # Shopify, Amazon, POS system connectors
/jobs # Real-time sync, pricing updates, overselling prevention
/evaluators # Stock accuracy, pricing consistency, exception rates
/gold-data # Sample products, pricing tiers, inventory levels
Perfect for: E-commerce retailers, multi-channel sellers, inventory-heavy businesses$3
CRM Lead Management & Attribution
bash
quallaa outcome --template lead-lifecycle-core
`
Generates complete lead operations:
/contracts # Lead, Activity, RoutingRule, SLATarget schemas
/integrations # HubSpot CRM, Google Analytics 4 connectors
/jobs # Lead scoring, deduplication, SLA monitoring
/evaluators # Response times, conversion rates, attribution accuracy
/gold-data # Sample leads, activities, conversion funnels
Perfect for: SaaS companies, marketing teams, sales operations$3
Financial Reconciliation & Accounting
bash
quallaa outcome --template order-cash-reco
`
Generates automated financial workflows:
/contracts # Order, Payment, AccountingEntry schemas
/integrations # Shopify, Stripe, Xero/QuickBooks connectors
/jobs # Daily reconciliation, exception handling, audit trails
/evaluators # Match rates, timing accuracy, manual intervention metrics
/gold-data # Sample orders, payments, accounting entries
Perfect for: E-commerce finance teams, accounting departments, CFO operationsš Installation & Commands
bash
Install globally
npm install -g quallaa-cliOr use npx (no install)
npx quallaa-cli@latest init
`$3
####
Initialize a new project with infrastructure services
bash
quallaa init --name my-startup --role founder
quallaa init --minimal # Headless worker variant (no UI)
`####
Create a project from business workflow templates
bash
Interactive selection from all 5 templates
quallaa outcomeOr specify directly
quallaa outcome --template project-invoice-guardrails
quallaa outcome --template donor-member-rollups
quallaa outcome --template inventory-pricing-sync
quallaa outcome --template lead-lifecycle-core
quallaa outcome --template order-cash-reco
`####
Check system health and configuration
bash
quallaa doctor # Basic health check
quallaa doctor --audit-secrets # Security audit
quallaa doctor --verbose # Detailed output
`####
Measure outcome performance metrics
bash
quallaa evaluators run --format html # Visual scorecard
quallaa evaluators run --format json # Machine-readable
quallaa evaluators run --format text # Terminal output
`####
Generate or enhance AI context files
bash
quallaa generate claude # Basic CLAUDE.md
quallaa generate claude --augment # Enhanced with project analysis
`šļø Architecture Choices
$3
Full-stack Next.js application with background processing
- Stack: Next.js, Vercel, Supabase, Resend
- Use for: Customer-facing apps, dashboards, CRMs
- Deploy to: Vercel$3
Minimal Node.js workers for batch processing
- Stack: Node.js, TypeScript, cron jobs
- Use for: ETL, reconciliation, automation
- Deploy to: Fly.io, Railwayš What Gets Measured
Every outcome template includes evaluators that measure:
- Accuracy: How often do we get the right answer? (target: ā„90%)
- Rework Ratio: How often does someone intervene? (target: ā¤5%)
- Processing Time: How fast per item? (target: ā¤5s)
- Unit Cost: What does each operation cost? (target: ā¤$0.10)
Run
to generate scorecards in HTML, JSON, or text format.š Role-Based Configuration
Choose your role for customized setup and AI context:
$3
- Architecture decisions and scaling
- Technical debt management
- Team processes and tooling$3
- User stories and requirements
- Analytics and A/B testing
- Feature flags and rollouts$3
- Attribution and campaign tracking
- Conversion optimization
- Marketing automation$3
- Process automation
- Data pipeline management
- Reporting and dashboardsš§ Supported Services
$3
All infrastructure services have generous free tiers:- Vercel - Hosting and deployment
- Supabase - Database and authentication
- GitHub - Version control
- Resend - Transactional email
- Typesense - Search (optional)
- Neon - Serverless Postgres (alternative to Supabase)
$3
Production-ready connectors for major business systems:- HubSpot CRM - Lead management and sales pipeline
- Google Analytics 4 - Web analytics and attribution
- Harvest - Time tracking and project billing
- QuickBooks Online - Accounting and financial reporting
- Stripe - Payment processing and payouts
- Shopify - E-commerce platform integration
- NeonCRM - Nonprofit donor management
š Security & Credentials
$3
- Credentials stored securely in OS keychain (macOS Keychain, Windows Credential Vault, Linux Secret Service)
- Never committed to code
- Automatic rotation reminders$3
For team collaboration and CI/CD:
1. Export credentials to GitHub Secrets or Vercel Environment Variables
2. Use restricted API keys with minimum required scopes
3. Rotate keys quarterly (doctor command reminds you)`bash
Audit your security posture
quallaa doctor --audit-secrets
`š Documentation & Support
- Documentation - See this README for complete usage guide
- Changelog - Version history and updates
- Issues - Report bugs or request features
- Examples - Coming soon at github.com/jefftoffoli/quallaa-examples
š ļø Troubleshooting
bash
Check everything is working
quallaa doctorVerify service authentication
quallaa doctor --verboseAudit for security issues
quallaa doctor --audit-secretsUpdate to latest version
npm update -g quallaa-cliOr with npx (always latest)
npx quallaa-cli@latest doctor
`šÆ Philosophy
Domain Engineering: Bridge the gap between business expertise and technical implementation
- Ship Outcomes, Not Code: Focus on business results, not technology
- Minimalist & Disposable: Build simple systems meant to be replaced
- Measure What Matters: Track business metrics, not technical metrics
- AI-Ready Context: Give AI assistants deep domain understanding
š¦ What's in the Box?
After running
, your project includes:`
project-name/
āāā contracts/ # JSON schemas for data structures
āāā connectors/ # Service integrations (or /integrations for minimal)
āāā jobs/ # Background workers and cron jobs
āāā evaluators/ # Gold datasets and scoring scripts
āāā exceptions/ # Error handling and manual review queues
āāā lib/ # Domain logic and utilities
āāā app/ # Next.js pages (web variant only)
āāā api/ # API endpoints
āāā CLAUDE.md # AI context file
āāā .env.example # Environment variables template
āāā package.json # Dependencies and scripts
š¢ Deployment
Both architectures are production-ready:
$3
bash
vercel deploy
`$3
bash
fly launch
fly deploy
`š¤ Contributing
This is a living tool that improves with community feedback. Contributions welcome!
1. Fork the repository
2. Create your feature branch (
)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Requestš License
MIT - see LICENSE file for details
š Acknowledgments
Built for domain experts who ship real business value. Special thanks to the early adopters testing outcome templates in production.
---
Ready to ship an outcome? Start with
quallaa outcome --template order-cash-reco` and have a working system in 90 seconds.