Add root README

.claude/CLAUDE.md

@@ -13,10 +13,10 @@ Even if you don't reach the goal, what you leave behind is just as valuable. Eve
 
 The fleet has four roles:
 
-- **Fleet Manager (FM)**: maintains the templates and tooling that reach you through this harness. Your operating environment comes from the FM.
-- **Project Manager (PM)**: investigated the problem and distilled the findings into your prompt.
-- **Worker**: you. One cast, one task, one repository, one goal.
-- **Supervisor**: verifies the outcome of each cast before the next one starts. Currently the Supreme Commander.
+- **Worker**: the operator. One cast, one task, one repo. Builds what the prompt asks for. Leaves a testament of what it learned.
+- **Project Manager (PM)**: tactical. Continuity across casts. Writes prompts, tracks state, discusses project direction with the SC.
+- **Fleet Manager (FM)**: strategic. Coherence across the fleet. Maintains templates, tooling, and references. Discusses fleet direction with the SC.
+- **Supervisor**: the direction. Currently the Supreme Commander.
 <!-- END:TEMPLATE:identity -->
 
 <!-- BEGIN:TEMPLATE:testament -->

.claude/testament/2026-04-13.md

@@ -0,0 +1,9 @@
+# 23:17
+
+This was a straightforward docs PR. Nothing technical to solve.
+
+The prompt ran twice because the first worker's version didn't include the "do not commit" instruction (it was added silently after dispatch). The PM post-mortem is documented in the prompt itself.
+
+The second Phase 1 run found a merge conflict in `.claude/CLAUDE.md` on main that the Supreme Commander had already resolved. The staged resolution carried over to the feature branch cleanly when it was created from origin/main.
+
+No CI surprises expected. The only files changed are `README.md`, `.claude/CLAUDE.md`, and this testament.

README.md

@@ -0,0 +1,27 @@
+# @shellicar/ecosystem
+
+Everything related to the @shellicar packages.
+
+## @shellicar TypeScript Ecosystem
+
+### Core Libraries
+
+- [`@shellicar/core-config`](packages/core-config/) - A library for securely handling sensitive configuration values like connection strings, URLs, and secrets.
+- [`@shellicar/core-di`](packages/core-di/) - A basic dependency injection library.
+
+### Build Tools
+
+- [`@shellicar/build-azure-local-settings`](packages/build-azure-local-settings/) - Build plugin that loads Azure local.settings.json with Key Vault reference resolution for non-Azure-Functions apps.
+- [`@shellicar/build-clean`](packages/build-clean/) - Build plugin that automatically cleans unused files from output directories.
+- [`@shellicar/build-graphql`](packages/build-graphql/) - Build plugin that loads GraphQL files and makes them available through a virtual module import.
+- [`@shellicar/build-version`](packages/build-version/) - Build plugin that calculates and exposes version information through a virtual module import.
+- [`@shellicar/graphql-codegen-treeshake`](packages/graphql-codegen-treeshake/) - A graphql-codegen preset that tree-shakes unused types from TypeScript output.
+
+### Framework
+
+- [`@shellicar/svelte-adapter-azure-functions`](packages/svelte-adapter-azure-functions/) - A [SvelteKit adapter](https://kit.svelte.dev/docs/adapters) that builds your app into an Azure Function.
+- [`@shellicar/cosmos-query-builder`](packages/cosmos-query-builder/) - Helper class for type safe advanced queries for Cosmos DB (Sql Core).
+
+### Logging & Monitoring
+
+- [`@shellicar/winston-azure-application-insights`](packages/winston-azure-application-insights/) - An [Azure Application Insights](https://azure.microsoft.com/en-us/services/application-insights/) transport for [Winston](https://github.com/winstonjs/winston) logging library.