aiwg
Version:
Cognitive architecture for AI-augmented software development with structured memory, ensemble validation, and closed-loop correction. FAIR-aligned artifacts, 84% cost reduction via human-in-the-loop, standards adopted by 100+ organizations.
59 lines (40 loc) • 1.83 kB
Markdown
# Usage Notes
AIWG is optimized for token efficiency through modular context loading and path-scoped rules.
## Account Compatibility
| Account Type | Suitability |
|--------------|-------------|
| **Claude Pro / Team** | ✅ Recommended |
| **API Pay-as-you-go** | ✅ Works well with cost monitoring |
| **Free tiers** | ⚠️ May hit rate limits on heavy workflows |
## Tips for Optimal Usage
1. **Start small** — Run individual workflows before full SDLC phases
2. **Use `--interactive`** — Control generation scope when needed
3. **Monitor usage** — Check your AI provider's dashboard for cost tracking
4. **Set budget alerts** — If your provider supports them
## Token Optimization
AIWG minimizes token usage through:
- **Path-scoped rules** — Only load context relevant to current file
- **Modular frameworks** — Install only what you need
- **Template reuse** — Consistent artifact structure reduces regeneration
## Rate Limits
If you hit rate limits:
1. Wait a few minutes before retrying
2. Use `--interactive` mode for smaller batches
3. Consider upgrading your account tier
4. Split large workflows into smaller steps
## Cost Management
**You are responsible for API costs.** The framework does not:
- Track or limit spending
- Provide cost alerts
- Guarantee cost estimates
- Refund unexpected charges
**Recommendations:**
- Start with simple workflows to gauge usage
- Monitor your provider's dashboard regularly
- Set budget alerts if available
- Use `--dry-run` flags when available to preview actions
## Technical Notes
- **Rate Limits:** Agentic tools handle rate limits and retries automatically
- **Version Control:** Document rollback is optional and user-controlled
- Enable by committing `.aiwg/` artifacts to git
- Or add `.aiwg/` to `.gitignore` for local-only use