Staff Engineer Architect is an enterprise-grade AI system design tool that leverages the "Staff Engineer" meta-prompt framework to synthesize production-ready architecture artifacts. It bridges the gap between high-level intent and concrete technical implementation, enforcing AppSec governance and Reality Filters™ to mitigate LLM hallucinations.

• AI Architecture Synthesis: Generates C4 diagrams, API contracts, and Terraform modules using Gemini 3 Pro.
• Reality Filters™: Pre-flight checks for Security, UX, and Brand compliance.
• Governance Console: Built-in content moderation queue and audit logging.
• Offline-First PWA: Workbox-powered hybrid caching for reliable access in zero-connectivity zones.
• Identity Management: Role-based onboarding and mock enterprise authentication flows.

• Frontend: React 19, TypeScript, Tailwind CSS
• AI Engine: Google Gemini API (@google/genai)
• PWA: Workbox v6, Service Worker
• Icons: Lucide React
• Build: Vite (Assumed) / Custom Webpack

• Node.js v18+
• Google Cloud API Key (Gemini)

1. Clone the repository

   git clone https://github.com/intellinc/se-architect.git
   cd se-architect

2. Install dependencies

   npm install

3. Configure Environment Create a .env file in the root directory:

   # Required for Architecture Synthesis
   API_KEY=your_google_gemini_api_key_here

4. Start Development Server

   npm start

The application is designed as a static Single Page Application (SPA).

npm run build

This generates a dist/ folder containing the optimized assets and the generated Service Worker (sw.js). Deploy this folder to any static host (Netlify, Vercel, S3+CloudFront).

Run the smoke test suite to verify synthesis integrity:

npx vitest tests/smoke.test.ts

Detailed documentation is available in the /docs directory:

• Architecture Overview
• Security Posture
• API Reference
• Local Database Schema
• Runbook

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

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

Generated by Staff Engineer Architect Core Team