Unified engineering standards, tools, and templates for all projects.
Status: Production - Consolidated LegalAI + AdHub innovations Next: v0.3.0 - eng-platform-mcp meta server
This repository contains:
- Shared configs - ESLint, Prettier, TypeScript, Git hooks
- Templates - CLAUDE.md, PR templates, CI workflows
- Custom MCP servers - ARE/QRE engines, basin analysis, constraint validation, team analytics
- MCP curation - Evaluated marketplace servers with version control
- Automation scripts - Audit, compliance checking, migration
- Tool experimentation - A/B testing framework for data-driven standardization
- Team analytics - Track tool effectiveness and engineer health
- Process docs - Code review, protected code, sprint workflow
# Clone platform
git clone https://github.com/YOUR-ORG/eng-platform
# Copy templates
cp eng-platform/templates/CLAUDE.md ./
cp eng-platform/templates/github/PR_TEMPLATE.md ./.github/
cp -r eng-platform/templates/ci/ ./.github/workflows/
# Install configs
npm install --save-dev \
eslint prettier typescript \
@typescript-eslint/parser @typescript-eslint/eslint-plugin
# Extend configs
echo 'module.exports = require("./eng-platform/configs/eslint/react")' > .eslintrc.js# ⚡ SIMPLE PROMPT (just copy & paste):
# See: PROMPT-ADD-TO-EXISTING.md
#
# 📚 DETAILED GUIDE (with explanations):
# See: ADD-TO-EXISTING-PROJECT-PROMPT.md
#
# 🆕 FOR NEW PROJECTS:
# See: ADD-TO-REPO-PROMPT.md
# The simple prompt will:
# - Analyze your current setup
# - Add git submodule at .eng-platform/
# - Set up MCP servers (beads, team-analytics)
# - NOT overwrite your configs (safe for production)# Track which tools your team uses and measure effectiveness
# See: tools-registry.json for available tools
# Start an experiment
node scripts/manage-experiments.js start exp-001-strict-linting
# Record weekly progress
node scripts/manage-experiments.js checkpoint exp-001-strict-linting
# Complete and analyze
node scripts/manage-experiments.js complete exp-001-strict-linting# ⚡ SIMPLE PROMPT (just copy & paste):
# See: PROMPT-CONTRIBUTE-TOOL.md
#
# 📚 DETAILED GUIDE (with examples):
# See: CONTRIBUTE-TOOL-PROMPT.md
# The simple prompt will:
# - Extract your tool
# - Remove project-specific code
# - Add to eng-platform
# - Create PR for revieweng-platform/
├── audits/ # Historical audit results
│ ├── legalai-system/ # Phase 1-3 audit outputs
│ └── adhub/ # AdHub audit + ADRs
├── configs/ # Shared configs
│ ├── commitlint/ # Conventional commits enforcement
│ ├── husky/ # Git hooks
│ └── playwright-reporters/ # Custom Playwright reporters
├── experiments/ # Tool A/B testing framework (NEW)
│ ├── tool-experiments.json # Active/completed experiments
│ └── experiment-schema.json # Experiment data schema
├── templates/ # Templates and hooks
│ ├── protection-guard-hook/ # PreToolUse hook for code protection
│ └── github/ # PR templates, CI workflows
├── skills/ # ÆtherLight Skills (8 domain-agnostic skills)
│ ├── code-analyze/ # Pattern analysis
│ ├── protect/ # Code protection annotation
│ ├── protection-audit/ # Protection compliance
│ └── ... # + 5 more
├── mcp-servers/ # Custom-built MCP servers (9 servers)
│ ├── research-swarm/ # ARE/QRE research engine
│ ├── basin-analyzer/ # Context drift detection
│ ├── constraint-validator/ # Z3 SMT solver
│ ├── report-writer/ # Report generation
│ ├── ragflow/ # RAG orchestration
│ └── ... # + 4 more
├── mcp/ # MCP marketplace curation
├── scripts/ # Automation tools
│ ├── manage-experiments.js # Tool experiment management (NEW)
│ ├── test-determinism-gate.js # Anti-hallucination tests
│ ├── team-sync-check.js # Environment validation
│ ├── setup-posthog-flags.js # Feature flag management
│ └── metrics/ # DORA metrics collection
├── tools-registry.json # Tool catalog for experimentation (NEW)
├── workflows/ # CI/CD workflows (5 workflows)
│ ├── nightly-e2e.yml # Cross-browser E2E tests
│ ├── regression-tests.yml # 5-layer regression
│ └── ... # + 3 more
└── docs/ # Process documentation
- ESLint Base - Core linting rules
- ESLint TypeScript - TS-specific rules
- ESLint React - React/JSX rules
- Prettier - Code formatting
- TypeScript - Shared TS config
- Git Hooks - Pre-commit, commit-msg hooks
- CLAUDE.md Template - AI context file structure
- PR Template - Pull request template
- CI Workflows - GitHub Actions templates
- tools-registry.json - Catalog of development tools for tracking and experimentation
- Experiments Framework - A/B testing system for tools
- team-analytics MCP - Engineer health monitoring with tool effectiveness tracking
- Experiment Management - CLI for running controlled tool experiments
- Apply to Project Guide - 3 strategies for syncing eng-platform to repos
- 9 Domain-Agnostic Servers - Production-ready MCP implementations
- research-swarm - ARE/QRE multi-step research engine
- basin-analyzer - Context drift detection & confidence scoring
- constraint-validator - Z3 SMT solver for conflict detection
- report-writer - Automated report generation
-
- 5 more (ragflow, postgres, mysql, dropbox, mcp-saas-template)
- Curated List - Tier 1/2/3 marketplace servers
- Evaluation Criteria - How to evaluate new servers
- Evaluation Log - Decision history
- Audit Project - Run Phase 1-3 audit
- Check Compliance - Validate against standards
- Migrate to Platform - Apply standards
- MCP Orchestration Vision - AI-native platform evolution
- Repo #2 Audit Kit - Enhanced multi-repo consolidation
- npm Publishing Guide - Package distribution strategy
- Processes - Code review, protected code, testing
- Runbooks - New project setup, machine setup
- Decisions - Architecture Decision Records (ADRs)
- 11 AdHub innovations integrated and cleaned for domain-agnostic use
- Protection Guard Hook - Automatic code protection enforcement via PreToolUse
- ÆtherLight Skills (8 skills) - AI-native workflow automation
- Determinism Gate - Anti-hallucination test detection
- DORA Metrics - Engineering velocity tracking
- 5-Layer Regression Testing - Dependency-based test organization
- PostHog Feature Flags - Dependency graph architecture
- commitlint Enforcement - 100% conventional commits
- Team Sync Check - Environment validation
- 5 CI/CD Workflows - E2E, regression, drift detection, metrics, database validation
- Playwright Reporters - PostHog + feedback integration
- 3 ADRs - Vitest migration, Protection Guard, REST vs tRPC (case studies)
- 9 domain-agnostic MCP servers extracted from LegalAI
- research-swarm - ARE/QRE research engine with formula scoring
- basin-analyzer - Context drift detection (epsilon metric, basin clustering)
- constraint-validator - Z3 SMT solver for logical conflicts
- report-writer - Automated report generation
- ragflow - RAG orchestration with Elasticsearch
-
- postgres, mysql, dropbox, mcp-saas-template
- Generated from LegalAI_System audit (Phase 1-3)
- Base configs for ESLint, Prettier, TypeScript
- CLAUDE.md template with protected code pattern
- MCP marketplace curation (Tier 1: 5 servers)
- Audit & compliance scripts
- Phase 1-3: Audit LegalAI_System
- Generate v0.1.0 from LegalAI audit
- Extract custom MCP servers → v0.2.0
- Document bidirectional sync strategies
- Phase 1-3: Audit AdHub (Repo #2)
- v1.0.0: Consolidate LegalAI + AdHub innovations
- Clean all files for domain-agnostic use
- ADRs documenting real-world decisions
- v0.3.0: Build eng-platform-mcp (meta MCP server)
- v0.4.0: Publish configs as npm packages
- v0.5.0: Publish MCP servers as npm packages
- v2.0.0: Self-organizing platform + Monorepo
- Quarterly MCP reviews
- Apply to both repos (validation)
- Migration scripts for existing projects
See CONTRIBUTING.md for how to propose new standards.
MIT - Internal use for [YOUR-ORG] projects