developing-claude-code-plugins

This monorepo serves as the Source-of-Truth (SoT) for all FlashFusion projects, tools, and agents. It uses a SoT canonical ownership model where all changes are made here and pushed to downstream mirrors.

Key Highlights

✅ Production Infrastructure: Complete CI/CD with automated security scanning

✅ Excellent Documentation: 95/100 score with comprehensive guides

✅ Strong Security: No critical vulnerabilities, automated dependency updates

✅ Modern Stack: pnpm workspaces, Turborepo, TypeScript 5.4+, React 19

✅ Consolidation Complete: 51/54 repos imported (94%), 3 unavailable

✅ Agent Framework: Unified AI agent architecture - All 4 agents implemented (Claude, Gemini, GitHub, Codex)

Repository Count

• Local repos: 4 (flashfusion-consolidated, HarvestFlow, INT-Smart-Triage-AI-2.0, MCP-Cloud-Demo)
• Krosebrook: 34 repos (all imported)
• flashfusionv1: 5 repos (3 unavailable/deleted)
• ChaosClubCo: 8 repos (all imported)
• Total: 54 repositories (51 imported, 3 unavailable)

```

source-of-truth-monorepo/

├── projects/ # All project code

│ ├── local/ # Local-only repos

│ ├── krosebrook/ # Krosebrook org repos

│ │ ├── core/ # Core FlashFusion projects

│ │ ├── apps/ # Applications

│ │ └── tools/ # Development tools

│ ├── flashfusionv1/ # FlashFusionv1 org repos

│ └── chaosclubco/ # ChaosClubCo org repos

├── agents/ # AI agent implementations

│ ├── claude-agent/

│ ├── codex-agent/

│ ├── gemini-agent/

│ └── github-agent/

├── shared/ # Shared utilities

│ ├── auth/ # Authentication & authorization

│ ├── contracts/ # Agent output schemas

│ ├── logging/ # Structured logging

│ ├── otel/ # Observability (OTEL)

│ └── workflows/ # CI/CD utilities

└── .github/ # GitHub workflows

```

• Package Manager: pnpm 9.x
• Build Tool: Turbo
• Versioning: Changesets (independent package versions)
• CI/CD: GitHub Actions
• Security: gitleaks, Renovate, pnpm audit
• Observability: Structured JSON logs, OTEL-ready

Prerequisites

• Node.js 20+
• pnpm 9+

Installation

```bash

# Clone the repository

git clone git@github.com:Krosebrook/source-of-truth-monorepo.git

cd source-of-truth-monorepo

# Install dependencies (includes security patches)

pnpm install

# Run all quality checks

pnpm format:check

pnpm lint

pnpm type-check

# Build all projects

pnpm build

# Run tests with coverage

pnpm test:coverage

```

Development

```bash

# Start dev mode for all projects

pnpm dev

# Build only changed projects

pnpm build --filter=...[HEAD^]

# Lint specific project

pnpm --filter @flashfusion/project-name lint

```

This monorepo includes an automated consolidation script to import additional repositories from GitHub.

Quick Start

```bash

cd scripts

# Install dependencies

pip install -r requirements.txt

# Set GitHub token

export GITHUB_TOKEN=your_github_token

# Test with dry-run

python consolidate.py --phase 1 --dry-run

# Execute consolidation

python consolidate.py --phase 1

```

Features

• ✅ Fetches all repos from GitHub user (currently configured for Krosebrook)
• ✅ Filters by language (JS/TS, Python, Java, C#, PHP, HTML/CSS)
• ✅ Auto-categorizes into apps/services/libraries/tools/etc.
• ✅ Progress tracking with real-time progress bars
• ✅ Error handling and resume capability
• ✅ Dry-run