Somnio Technology Tools

A centralized repository for Somnio Software's technology department containing all tools developed to accelerate project analysis, improve code quality, and optimize development processes.

🎯 Purpose

This repository's main objectives are:

• Centralize tools: Keep all analysis and development tools in one place
• Accelerate analysis: Provide automated tools to evaluate project health
• Improve quality: Establish consistent development standards and processes
• Optimize processes: Automate repetitive analysis and auditing tasks
• Facilitate maintenance: Create reusable and scalable tools

⚡ Getting Started

📦 Install the CLI

Before using any tools, install the Somnio CLI to easily install and manage AI agent skills:

dart pub global activate --source git https://github.com/somnio-software/flutter-health --git-path cli

🚀 Quick Start

Once installed, auto-detect available agents (Claude Code, Cursor, Antigravity) and install all skills:

somnio init

This command will:

• 🔍 Detect which AI agents are available on your system
• 📥 Install all available skills to each detected agent
• ✅ Set up everything you need to start using the tools

📚 CLI Documentation

For detailed CLI usage, commands, and advanced options, see the CLI README.

Available CLI Commands:

• somnio init - Auto-detect and install skills to all agents
• somnio claude - Install skills to Claude Code
• somnio cursor - Install commands to Cursor
• somnio antigravity - Install workflows to Antigravity
• somnio status - Show installed skills status
• somnio run <code> - Run a health audit step-by-step from the project terminal (with per-step token usage tracking)
• somnio quote (or somnio q) - Display a random Somnio team quote
• somnio update - Update CLI and reinstall skills
• somnio add - Add new technology skill bundles

🏃 Running Audits from the Terminal

Use somnio run from the target project's root to execute a full health audit. The CLI handles setup steps (tool installation, version alignment, test coverage) directly via pre-flight, then delegates analysis steps to an AI CLI (Claude or Gemini) in fresh contexts.

# From a Flutter project root
somnio run fh

Code	Audit
fh	Flutter Project Health Audit

You can specify a model with --model (-m) or select one interactively. Each CLI has a sensible default: haiku for Claude and gemini-3-flash for Gemini.

somnio run fh --model opus          # Use a specific Claude model

Artifacts are saved to ./reports/.artifacts/ and the final report to ./reports/. See the CLI README for all flags (--agent, --model, --skip-validation, --no-preflight).

🛠️ Available Tools

This repository contains technology-specific auditing and analysis tools organized by technology stack:

📁 Repository Structure

technology-tools/
├── flutter-plans/                        # Flutter tools
│   ├── flutter_project_health_audit/     # Health audit system
│   ├── flutter_best_practices_check/     # Code quality checker
│   └── README.md
└── README.md                            # This file

Each tool directory contains:

• cursor_rules/ - Analysis rules (YAML files)
• plan/ - Execution plans
• prompts/ - AI prompts for enhanced analysis
• README.md - Tool-specific documentation

For new tools

1. Create new folder with descriptive name (e.g., react/, nodejs/)
2. Include complete documentation in README.md within the folder
3. Update this main README with the new tool category

🔧 Development

Adding new tools

1. Create folder with descriptive name
2. Include complete documentation in README.md within the folder
3. Update this main README with the new tool category
4. Follow established documentation standards

Documentation standards

• Complete README.md in each technology folder
• Clear usage instructions
• Practical examples
• Documented file structure
• Tool-specific details should be in the technology folder's README

Code Quality Standards

All YAML rule files follow strict formatting standards:

• Line Length: Maximum 80 characters per line
• Formatting: Commands split using shell continuation (\)
• Descriptions: Use folded scalar format (>) for multi-line text
• Readability: Optimized for maintainability and consistency

📈 Roadmap

• Flutter Project Health Audit
• Flutter Best Practices Check
• Security analysis tools
• Deployment automation
• Performance and quality metrics

🤝 Contributing

1. Fork the repository
2. Create feature branch: git checkout -b feature/new-tool
3. Commit changes: git commit -m 'Add new tool'
4. Push to branch: git push origin feature/new-tool
5. Open Pull Request

Development guidelines

• Follow established folder structure
• Document each tool completely in its technology folder
• Include usage examples
• Maintain backward compatibility

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

For questions, issues, or contributions:

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Pull Requests: GitHub Pull Requests

🏢 About Somnio Software

This project is maintained by Somnio Software, a company focused on delivering high-quality software solutions and development tools.

---

Made with ❤️ by the Somnio Software team