The Software Engineering wing of the Institute of Conceptual Studies, Deepworks is dedicated to creating open source tools and standards that enhance development, ensure code consistency, and provide robust solutions to common engineering challenges. Our work is grounded in Formal Conceptual Models (FCM) — treating infrastructure as formally-defined, composable systems rather than ad-hoc scripts.
Great tasting code, just like mom used to make!
To quiet the DIY voice in developers' heads by providing well-crafted, standardized solutions to common software engineering problems. We believe in:
- Consistency: Establishing and maintaining high standards across projects
- Efficiency: Reducing development time through reusable components
- Quality: Ensuring robust, tested, and maintainable code
- Community: Contributing to and benefiting from open source collaboration
Our github.toolkit repository provides abstracted, reusable GitHub Actions — built from FCM definitions on a six-layer architecture — for:
- Version calculation
- Release management
- Changelog maintenance
- Branch, tag, and commit operations
The FCM approach underpins our tooling:
- Formally-defined, composable building blocks
- A bridge architecture mapping models to GitHub-native compatibility
- Standardized project templates and shared utilities
.github Repository (You are here)
- Organization-wide GitHub configurations
- Shared workflow templates
- Default community health files
- Organizational documentation
We welcome contributions! Each repository contains specific guidelines, but generally:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
All Deepworks repositories follow:
- Semantic versioning
- Conventional commits
- Automated changelog generation
- Comprehensive documentation requirements
Each Deepworks repository includes:
- Clear README documentation
- Standardized changelog format
- GitHub Actions workflows
- Contribution guidelines
All repositories use:
- MkDocs for documentation sites
- Material theme for consistent styling
- Automated deployment to GitHub Pages
- Version-controlled documentation
- Organization GitHub
- Email: [email protected]
- Project-specific issues should be raised in their respective repositories
Unless otherwise specified, Deepworks projects are released under the MIT License.
Deepworks is part of the Institute of Conceptual Studies, working to advance software engineering practices through practical, reusable solutions.