Phenotype Polyrepo Shelf

Pinned references (Phenotype-org)

• MSRV: see rust-toolchain.toml
• cargo-deny config: see deny.toml
• cargo-audit: rustsec/audit-check@v2 weekly
• Branch protection: 1 reviewer required, no force-push
• Branching baseline: canonical repo checkout should stay on main unless doing merge/pull
• Governance authority: phenotype-org-governance/SUPERSEDED.md when present in the relevant repo

This root is a polyrepo shelf for the Phenotype organization: one workspace directory containing many independent repositories, landing pages, shared libraries, and operational runbooks. It is intentionally a central index, not a replacement for each project's README.

projects/INDEX.md has been checked and is currently missing, so this README acts as the shelf index.

About this shelf

• Canonical repository layout: each first-level directory ending in a normal project name is the canonical checkout for that project.
• Feature work: perform feature work in project worktrees under *-wtrees/ and keep canonical directories aligned to main.
• Cross-project standards: quality, spec, and governance expectations are documented in shelf-level docs and project-specific AGENTS/CLAUDE files.
• Per-repo docs first: the README in each project folder is authoritative for setup, build, and workflow.

Getting Started

1. Pick a project directory from the table below.
2. Open that project's own README (<project>/README.md).
3. For any active implementation, use the project worktree under <project>-wtrees/.
4. Track implementation work in this shelf's AgilePlus feature specs:
   • AgilePlus specs (spec index)
   • Shelf worklogs
5. Use shelf docs for cross-project context:
   • docs/ for org policies, ADRs, and process references
   • docs/worklogs/ for ADR-like decisions, research notes, and issue findings

Major repos and project index

This is a curated index of the most active/major repos in this checkout.

AgilePlus (shelf tracking)

Project	Description
AgilePlus	Local-first spec-driven agile work-tracking CLI/platform for AI-agent and human teams; manages feature specs, work packages, acceptance criteria, optional GitHub sync, dashboards, and P2P merge. Install from AgilePlus/ with cargo install --path crates/agileplus-cli; see AgilePlus/README.md.

Agent orchestration and LLM execution

Project	Description
thegent	Agent runtime and decomposition framework for multi-actor execution.
thegent-dispatch	Dispatch service for routing worker workloads across providers.
thegent-workspace	Workspace scaffolding and state model for thegent.
thegent-landing	Marketing/landing site for thegent.
cheap-llm-mcp	MCP server for routing low-cost model usage.
dispatch-mcp	Single endpoint MCP dispatch utility.
agentapi-plusplus	API gateway and protocol adapters for agent workflows.
agent-user-status	Presence/status service for user-facing agent interactions.
agent-devops-setups	Provisioning and orchestration setup helpers.
agentops-policy-federation	Cross-agent policy federation.
Agentora	Agent orchestration product.
PhenoAgent	Agent SDK for the Phenotype runtime.
phenoForge	Phenotype-flavored Forge integrations.
forgecode	Forge agent integration scaffolding.

MCP, APIs, and routing infrastructure

Project	Description
agileplus-mcp	MCP integration surface for AgilePlus.
AgentMCP	Experimental MCP scaffolding repository.
McpKit	MCP server scaffolding kit.
MCPForge	MCP server forge tooling.
cliproxyapi-plusplus	Multi-provider CLI proxy and API compatibility surface.
helios-router	Routing layer for LLM/agent requests.
helios-cli	CLI client for Helios workflows.
helioscope	App manager (formerly heliosCLI).
PhenoMCP	MCP runtime and plugin scaffolding.
vibeproxy	LLM/dev traffic proxy.
vibeproxy-monitoring-unified	Unified monitoring stack for vibeproxy.
Httpora	HTTP utilities/proxy.

Core platform + shared crates

Project	Description
pheno	Core Phenotype platform workspace (multiple subproducts).
phenoShared	Shared cross-repo Rust crates and helpers.
PhenoRuntime	Runtime abstractions used across Phenotype components.
PhenoControl	Control-plane primitives and policy wiring.
PhenoSchema	Shared schema and contract types.
PhenoPlugins	Plugin framework and extension points.
PhenoKits	Kit-level tool and artifact collection (umbrella).
PhenoEvents	Event bus and signal model.
PhenoLang	Language/tooling support.
PhenoCompose	Composition and orchestration helpers.
phenotype-shared	Historical alias path for shared crates (same repo as phenoShared).

Product applications

Project	Description
heliosApp	Product application workspace for helios.
HeliosLab	Experimentation and analytics workspace for helios.
heliosBench	Benchmarking project for helios execution performance.
BytePort	Network transport and endpoint-oriented product.
Tokn	Token operations and pricing governance.
Tracera	Traceability system for event and execution history.
Observably	Product-level observability surface.
hwLedger	Hardware and capacity ledger for fleet/operations planning.
PolicyStack	Governance/policy engine and compliance tooling.
Planify	Planning utilities and work lifecycle helpers.
Sidekick	Assistant-side operational helper.
Eidolon	Phenotype's Eidolon domain project.

Tooling and infrastructure

Project	Description
FocalPoint	Central operations tooling, including target-pruner utilities.
Configra	Configuration management framework.
Conft	Flag/config control service.
PhenoObservability	Logging, tracing, telemetry, and monitoring stack.
ObservabilityKit	Reusable observability building blocks.
PlatformKit	Cross-platform platform utilities.
HexaKit	Architecture and scaffolding utilities.
phenotype-infra	Infrastructure-as-code and org automation.
phenoAI	AI service integrations and helpers.
ValidationKit	Validation and policy checks.
TestingKit	Test scaffolding and quality helpers.
rich-cli-kit	Rich terminal UX helpers.
ResilienceKit	Resilience patterns library.
Tracely	Trace explorer.
Metron	Metric collection service.
Tasken	Task scheduler.
Civis	Civis project.
Benchora	Benchmarking service.
QuadSGM	QuadSGM project.
localbase3	Local DB / storage layer.
KDesktopVirt	Desktop virtualization.
bare-cua	Bare computer-use-agent harness.
PlayCua	Computer-use agent playground.
AppGen	App generator.
DevHex	DevHex product.
Dino	Dinoforge core.
dinoforge-packs	Dinoforge governance packs.
DINOForge-UnityDoorstop	Unity Doorstop integration.
KlipDot	KlipDot product.
Pine	Pine project.
Parpoura	Parpoura project.
Paginary	Pagination service.
netweave-final2	Netweave experiment.
foqos-private	Foqos (private).
argis-extensions	Argis editor extensions.
AtomsBot	Atoms bot (archived; retained for history).
chatta	Chatta workspace.
portage	Portage workspace.
portage-adapter-core	Portage adapter core.
nanovms	NanoVM integration.
GDK	Game/graphics dev kit.
DataKit	Data-pipeline kit.
AuthKit	Auth kit.
kwality	Quality / scorecard tooling.
phenoUtils	Shared utilities.
phenoDesign	Design system primitives.
phenodocs	Phenotype documentation site.
phenodocs-scorecard-remediation	Doc scorecard remediation harness.
PhenoHandbook	Phenotype handbook.
phenotype-auth-ts	TypeScript auth client.
phenotype-bus	Message bus.
phenotype-hub	Discovery / registry hub.
phenotype-registry	Artifact registry.
phenotype-journeys	User-journey traceability.
phenotype-omlx	OMLX integration.
phenotype-ops-mcp	Ops MCP surface.
phenotype-org-audits	Org-wide audit reports.
phenotype-tooling	Cross-repo tool chest.
phenotype-icons	Icon set.
phenotype-previews-smoketest	Preview/smoketest harness.
phenotype-skills	Claude skill definitions.
phenoXdd	XDD (cross-document development) tooling.
phenoResearchEngine	Research automation engine.

Landing pages and web surfaces

Project	Description
agileplus-landing	Marketing/landing site for AgilePlus.
byteport-landing	Marketing/landing site for BytePort.
hwledger-landing	Marketing/landing site for hwLedger.
phenokits-landing	Marketing/landing site for PhenoKits.
projects-landing	Organization-wide projects landing page.
frontend	Shelf-level frontend app surface.

Cross-cutting shelves and references

Path	Purpose
docs/worklogs/	Shelf-wide worklog index by category (ARCHITECTURE, RESEARCH, GOVERNANCE, etc.).
AgilePlus/kitty-specs/	Feature specs and task packages used by AgilePlus.
docs/	Shared references, ADRs, and reusable docs.
*-wtrees/	Project worktree directories (e.g. AgilePlus-wtrees/).
.github/scripts/	Shared CI and maintenance scripts.
AgilePlus/	Main platform implementation.

Notes

• Some directories are placeholders/landing/utility trees and may not represent standalone canonical products.
• This README is intentionally a shelf-level index; source-of-truth setup for each project stays in that project's own README.md.
• This index does not remove information from previous versions; it reorganizes it for polyrepo orientation and easier navigation.

---

Rich Media Stubs

[RICH MEDIA PLACEHOLDER — blocked on CLI build] Terminal capture of agileplus status immediately after agileplus init + agileplus epic create.

Blocked: agileplus-cli is not yet published from this workspace (cargo build -p agileplus-cli is the unlock). Once the binary exists, record via Capture in a Playwright or script session and render with phenotype-journeys/remotion/doc-embeds/bin/render.mjs. Workaround: use the web dashboard captures above for onboarding visuals until the CLI journey lands.

Keyframe pair from the epic-story-lifecycle Playwright capture (docs/embeds/journeys/epic-story-lifecycle.annotations.json). Remotion mp4/gif render is queued once API_PORT=4000 is up with seeded data; re-run render.mjs from phenotype-journeys/remotion/doc-embeds to publish the animated loop.

Three-step dashboard walkthrough captured via @phenotype/doc-embeds Capture helper (Overview → Epics → Stories). EmbedSpec: docs/embeds/journeys/dashboard-walkthrough.annotations.json. Re-capture with API_PORT=4000 DATABASE_PATH=agileplus.db for live epic/story counts, then npm run render -- --annotations … in phenotype-journeys/remotion/doc-embeds to drop dashboard-walkthrough.mp4 beside these stills.