constitution
Load and confirm core principles, guardrails, and project context for MacroFlow sessions.
When & Why to Use This Skill
The Constitution Skill serves as the foundational governance layer for MacroFlow sessions, enabling the definition and enforcement of core principles, technical constraints, and project context. It ensures that AI agents operate within specific guardrails, such as xAI alignment, neutral Markdown standards, and Azure DevOps integration, to maintain consistency and high-quality project analysis.
Use Cases
- Project Initialization: Setting the foundational vision, technical stack (C#, Azure), and operational constraints for a new development session to ensure alignment from the start.
- Compliance Enforcement: Automatically applying immutable rules and guardrails to ensure all AI-generated documentation follows specific architectural patterns like CQRS and Repository.
- Environment & Dependency Validation: Verifying the presence of required tools (PowerShell 7, Node.js, Azure CLI) and configuring MCP servers for seamless Azure DevOps connectivity.
- Role-Based Workflow Orchestration: Defining and assigning specific roles (e.g., Functional Consultant, Azure Architect) to ensure structured collaboration and time-boxed analysis.
| name | constitution |
|---|---|
| description | Load and confirm core principles, guardrails, and project context for MacroFlow sessions. |
Constitution Skill
Overview
The Constitution phase establishes the foundational principles, constraints, and manifesto for the project. It ensures alignment with Grok-native ecosystem, xAI principles, and truth-seeking development. For business problem/solution development and analysis, this phase sets the stage for neutral Markdown capture by roles like Functional Consultant, Azure Solution Architect, etc., ensuring time-boxed (32-hour) analysis and ADO MCP integration.
Purpose
- Define project vision and core values for requirements capture
- Establish technical and operational constraints (e.g., neutral Markdown, no branding)
- Align with Grok/xAI first principles and role-based collaboration
- Set the tone for lean, mean, truth-seeking development from raw notes to analysis
Inputs
- High-level project requirements (business problems, solutions)
- Stakeholder goals (e.g., client-neutral docs)
- Existing patterns, constraints, and role assignments
Process
- Review manifesto and Grok principles, confirming Grok-only stack and truth-seeking.
- Identify key constraints: 32-hour time-box for analysis, neutral Markdown (no branding), ADO MCP for work items, role-specific domains (e.g., SAP for ERP, Azure for cloud).
- Define success criteria: Complete analysis Markdown ready for Plan phase, with ADO links.
- Assign roles and orchestration: Functional Consultant for raw notes, Requirements Specialist for framework; Luna agent loads guardrails and prompts alignment.
- Configure MCP servers: Ensure acornsoftDevOpsServer are set for multi-instance ADO access in analysis/forensics.
- Check dependencies: Confirm VS Code Insiders/VS Code with skills, PowerShell 7+, Node.js, Pandoc, Azure CLI, Azure DevOps CLI, required extensions (GitHub Copilot, vscode-awesome-copilot, Mermaid Markdown Syntax Highlighting), MCP support, repos, and ADO PAT are installed/configured; test VS Code (code --version) and VS Code Insiders (code-insiders --version) versions; if not, ask user and guide setup (refer to setup.instructions.md). Verify access to Azure DevOps via MCP Server (acornsoftDevOpsServer in mcp.json) for work item tracking and artifact links. Ensure multiline fields (e.g., System.Description, System.History, Microsoft.VSTS.TCM.ReproSteps, Microsoft.VSTS.Common.Resolution) default to Markdown format at the organizational level for consistent rendering; if not configured, run az devops invoke to set them to Markdown.
- Document foundational decisions: Output constitutional framework with principles, roles, and boundaries.
Outputs
- Constitutional framework document (neutral Markdown)
- Key principles, constraints, and role assignments
- Dependency confirmation (e.g., VS Code, PowerShell 7, Node.js, Pandoc, extensions, repos setup)
- Alignment confirmation with xAI ecosystem and ADO integration
- Confirmation of multiline field formats set to Markdown (e.g., System.Description, System.History)
Grok Integration
Use Grok for first-principles reasoning to validate foundations. Temperature: 0.7 for creative alignment. Luna sub-agents (e.g., @Constitution) auto-load and enforce.
Next Phase
Proceed to Clarify when foundations are established, using MacroFlow-Analysis.md as a real-world example for iteration.
Instructions
- Load manifesto, Grok-native constraints, and current project context.
- Confirm guardrails: xAI/Grok stack, C# primacy, vertical slices, Apple-like UX.
- Reference key patterns: CQRS, Repository, Strategy, Composition over Inheritance.
- Output immutable rules applied globally.
Examples
- Input: Start MacroFlow for new project.
- Output: Summary of loaded context and constraints.
Learned Patterns
- Always start sessions with Constitution for consistency.
- Integrate with Grok modes for reasoning.