distillx. / teardown 26.08.03
← today's 5
VIRAL TODAY

yc-software/qm

QM is a well-engineered platform with genuine architectural strength in scope isolation and audit transparency, but the execution falls short of the security and operational positioning. The core wedge, safe, isolated agent workflows with egress transparency, addresses a real pain point for startups wary of black-box AI, but the platform ships with admitted security gaps (bypassable sandboxing, no memory redaction) and missing production patterns (cost control, skill isolation, persistent job queues).

The team's roadmap is credible and the code quality is solid enough to support hardening. Recommended for early adopters with security expertise who can audit and customize deployments, or teams that prioritize rapid iteration over compliance.

Not ready for risk-averse enterprises, zero-install hosted service deployments, or scenarios where the security claims will be validated against the code.

8847 stars 931 forks 109 issues TypeScript Alpha CI passing
Architecture62Maturity48Security32Reusability58Documentation42Testing23
62 / 100

ReadyBase score: Good, AI viable with verification. Deterministic, no LLM.

How ReadyBase scores this →

Distill this: 8 ideas worth adopting

ranked shortlist
14
Restrict sensitive operations to DM-only; prevent credential input and sign-in in channels or groups

Very high signal (2 personas), high generality (7/10), minimal cost (UX constraint already mostly implemented). Bakes audit trail into UX; prevents cross-user secret leakage.

10
Clarify README: frame Node.js/TypeScript/Fastify coupling as deliberate platform bet, not aspirational flexibility

Gap flagged by 2 personas, low cost (doc-only), addresses trust erosion. Evaluators will discover tight coupling; owning it preempts the discovery conversation.

8
Deploy with layering (deploy/layers/ keeps core byte-identical) and pre-commit hook to prevent secret leakage

Transferable (8/10), evidence from 2 personas (CPO, VPE), low-medium cost (2-4 hours tooling). Retention engine: conflict-free merges + upgrade paths without fork drift.

8
Gate write operations at skill level with prepared mutations and explicit approval before execution

Transferable (8/10), evidence from 2 personas (CPO, VPE), medium cost (standardize 20 skills). Audit trail is untrustworthy without prepared mutations; mostly already in place.

8
Track token and request budgets with rate limiters and advisory locks to prevent SaaS cost overruns

Transferable (8/10), evidence from 2 personas (CTO, Scrum Master), medium cost (instrument external calls). Operationally critical; hard to retrofit when traffic exists.

8
Materialize credentials into environment variables for shell commands, scoped per sandbox process

Transferable (8/10), evidence from 2 personas (CTO, CISO), medium cost (credential lifecycle per sandbox). Eliminates leakage between concurrent runs; removes global state as zero-day vector.

8
Use OAuth to delegate credential management to third-party providers rather than in-house token rotation

Transferable (8/10), evidence from 2 personas (CTO, CISO), medium cost (provider integration + token refresh). Shifts compliance burden to audited providers; eliminates HSM/rotation ops.

6.75
Isolate each person's data and activity by scope with separate workspaces, files, memory, keychain, and permissions

Highest evidence (3 personas: CTO, CPO, CISO), high generality (9/10), foundational for multi-tenant safety. Prevents privilege escalation and cross-user leakage. High adoption cost justified by impact.

What it does

QM is a multi-tenant agent harness for startups that isolates each person's data and activity by scope, gates write operations with approval before execution, and supports pluggable skills (Browse, Linear, GitHub, Admin, etc.) for internal tool automation. It deploys on Fly.io or AWS via a CLI with sandbox isolation and credential scoping per conversation.

The wedge

Multi-tenant scope isolation with per-scope credential materialization and optional egress transparency (--audit, --no-source-to-cloud). This differentiates QM from consumer chatbots by enabling controlled, auditable agent workflows in shared environments, but the wedge is weakened by a material gap: SECURITY.md admits command policy is bypassable via obfuscation, and the memory layer does not enforce redaction at the code level, undermining the claimed isolation.

Truth gap

SECURITY.md admits command policy is bypassable and memory redaction is instruction-only, contradicting the core safety narrative positioned to enterprises.

Findings board, 5 lenses on this repo

5 personas, 34 findings
CTO
Abstract persistence backends (sandbox, session store, model gateway) behind interfaces so deployments can swap implementations without core rewiring

Decouples core from infrastructure; enables 10x scale transitions (SQLite→Postgres→distributed store) without rewiring core logic

Cost Design interfaces upfront; maintain abstraction discipline across architecture

Isolate each person's data and activity by scope: separate workspaces, files, memory, keychain, permissions per conversation or team

Foundational multi-tenant safety; single point of control for data ownership and compliance enforcement

Cost Pervasive scope threading through every function; high cognitive load and test surface

Track token and request budgets across operations with rate limiters and advisory locks to prevent overspend in multi-agent deployments

Prevents runaway costs; operationally critical for SaaS unit economics; hard to retrofit

Cost Instrument every external call; complex async accounting and budget enforcement logic

Materialize credentials into environment variables for shell commands scoped per sandbox process, not as global state

Eliminates credential leakage between concurrent agent runs; removes global state as zero-day vector

Cost Credential lifecycle per sandbox; verify process isolation and cleanup; audit teardown

Use memory as an index of pointers to durable data, not the durable data itself; keep mutable state in workspace files

Separates ephemeral index from durable storage; prevents unbounded memory growth as scaling ceiling at 10x data

Cost Schema migration of existing data; audit trail of what leaves memory; consistency verification

Gap: SECURITY.md documents command policy is bypassable via obfuscation or script-writing; code provides no alternative sandbox boundary

Claimed sandboxing narrative is undermined; security posture materially weaker than documented to users

Cost Kernel-level isolation or mandatory approval re-architecture; substantial implementation friction

Delegate credential management to OAuth providers rather than storing or rotating tokens in-house

Shifts security and compliance burden to audited third parties; eliminates token rotation operations and HSM costs

Cost Provider lock-in risk; token refresh handling complexity; dependency on provider uptime

CPO
Scope-based isolation + per-scope credential materialization

Enables safe multi-tenant single deployment; prevents cross-user data/secret leakage, core differentiator vs consumer chatbots for startup employees.

Cost Already implemented; requires security audit, enterprise trust-building, and demonstrating 'not bypassable' for compliance deals.

Deployment layering (deploy/layers/ keeps core byte-identical)

Customers customize without forking; conflict-free merges preserve upgrade paths. SaaS retention engine, makes staying current painless vs fork drift.

Cost Discipline: developers must resist modifying core; requires clear boundary docs and automated enforcement tooling.

Skill-level approval gates + DM-only sensitive operations

Bakes audit trail and channel-leakage prevention into UX; transforms 'scary AI' into 'controlled tool' for enterprise compliance teams.

Cost Medium, users trade convenience for safety; training needed on which operations are approval-gated vs async.

Managed browser sessions with persistent sign-in profiles

Agents sign in once, reuse credentials across runs, eliminates manual re-login friction, unlocks seamless tool automation (Browse, SSO).

Cost High, requires operator infrastructure choice (Anchor/Kernel/Browserbase) and vendor integration; session state across restarts.

Gap: Security documented but not enforced (policy bypassable, memory unredacted)

SECURITY.md admits command policy is bypassable and secrets aren't redacted. Enterprise buyers demand enforced isolation; aspirational claims kill deals.

Cost Reframe story (own model-behavior trust) or rebuild sandboxing, both carry narrative and engineering cost.

Gap: README overstates model/harness flexibility (tightly coupled to Node/TypeScript)

Claims 'pick your model/harness' but code is Node/Fastify-only. Scope cuts fine if intentional; misleading promises erode technical evaluator trust.

Cost Low, clarify 'Node.js-focused platform' in docs and own it as deliberate platform bet, not limitation.

VPE
Gate write operations at skill level with prepared mutations before approval (skills-seed/linear/SKILL.md pattern); enforce at CLI, not model

Audit trail is only trustworthy if mutations are presented before execution; model-level gating is bypassable via prompt injection or obfuscation per SECURITY.md admission

Cost Moderate: add PreparedMutation struct to skill interface; audit all 20+ skills for approval hooks (mostly already in place, needs standardization)

Abstract layer boundaries (sandbox, session store, model gateway) so deployments swap implementations without forking core (src/wiring.ts already does this)

Tight coupling to TypeScript/Node/Fastify blocks multi-language harnesses and vendor migration; README claims 'pick your harness' but code is monolithic

Cost High: would require splitting core from harness layer; current approach (single wiring export) masks this until deployment diverges (6-12mo risk)

Ship CI/CD for test suites (test/orchestrator.test.ts, cli/test/e2e/ exist but no GitHub Actions); gate PRs on `npm test && npm run build`

Orchestrator changes (agent flows, entitlement checks, browser action filtering) ship untested; SECURITY.md admits bypassable policies but has no regression suite

Cost Low: <4 hours to add .github/workflows/test.yml with node:18+; existing tests are comprehensive (Orchestrator mocking, E2E CLI tests)

Document onboarding skill as dogfooding requirement; add CONTRIBUTING.md with 'run dev-instance locally, trace turn through orchestrator.test.ts' path

No documented entry point for new contributors; onboarding/SKILL.md exists but isn't shown to maintainers as the flow; CLAUDE.md is process-level, not execution-level

Cost Very low: 2-3 hours to write CONTRIBUTING.md, add Makefile with `make setup-dev`, reference existing onboarding/dev-instance skills

Decouple data persistence (mutable state in workspace files, memory as index only per src/resolution/protocols/shared-core.md); enforce read-only caching for session store

Memory gap (SECURITY.md: 'no secrets' policy enforced by instruction, not code layer) will leak when agents cache credentials across scopes; workspace isolation depends on storage, not access control

Cost High: refactor SessionStore abstraction to enforce per-scope key-value isolation; add tests for cross-scope leakage (8-12 sprints for multi-tenant safety)

Isolate skill implementations in separate worktrees during CI (not done; skills are single-threaded); test skill + skill interface contract independently

A broken skill (e.g., browse/providers/anchor.md auth flow) breaks orchestrator turns without warning; skills are in-process, no isolation between skill errors and core crashes

Cost High: adds process spawning overhead; benefits are isolation, independent skill versioning, and testing; needed for hosted multi-tenant SaaS (3-6mo work)

Store org customizations in deploy/layers/ (already implemented); ensure pre-commit hook prevents checked-in secrets, upstream merge conflicts by running scrub validation

Private forks already diverge from upstream; no automation to validate layer separation or enforce byte-identity on core files; silent divergence risk mentioned in README

Cost Low: add pre-commit hook script that runs `git ls-files deploy/layers/` check + fabric scrubber on diff; 2-4 hours

CISO
Gap: Memory documentation states 'no secrets' but persistence layer does not technically enforce or redact secrets written to memory

Secrets can leak into backups, logs, and transcript search if stored in memory; documentation/implementation mismatch creates false sense of security.

Cost Audit persistence layer, add redaction middleware, implement field-level encryption in memory stores; ~40h engineering.

Gap: SECURITY.md documents that command policy is bypassable via obfuscation or script-writing, but code provides no alternative sandboxing boundary

Agents can evade restrictions entirely; sandbox is advisory-only, making all downstream controls untrustworthy if agent is compromised.

Cost Redesign enforcement (OS syscall filters, immutable rootfs, seccomp); architectural change; ~200h + infrastructure rework.

Communicate credential purposes as instructions to the model, but do NOT enforce them at the authorization layer

Policies relying only on model instructions fail when agents are compromised, adversarial, or misconfigured; no technical enforcement mechanism.

Cost Add resource-level scoping and capability-based authz; ~60h engineering to retrofit policy enforcement.

Require human approval for write operations before executing; screen external data and tool results with a classifier before reaching the model

Prevents unauthorized data modifications, supply-chain attacks via agent compromise, and model injection from untrusted sources.

Cost UX flow for approval chains, classifier model/logic; ~30h engineering + operational overhead per approval.

Isolate each person's data and activity by scope, with separate workspaces, files, memory, keychain, and permissions for each conversation or team

Prevents privilege escalation, cross-user data leakage, and limits blast radius when agents or credentials are compromised.

Cost Foundational; requires compartmentalization across storage, identity, and access control systems; ~100h initial, ongoing maintenance.

Materialize credentials into environment variables for shell commands, not global state; each sandbox process sees only its scoped credentials

Limits credential exposure surface and ensures leaked env vars are scope-bound; process isolation becomes effective boundary.

Cost Refactor credential injection pipeline; mostly internal; ~20h engineering + integration testing.

Use one-time secret-drop URLs to collect sensitive credentials without transiting them through chat; redemption injects them into environment variables only

Prevents secrets from entering chat history, logs, transcript search, and backups; dramatically reduces forensic attack surface.

Cost Implement or integrate external secret-drop service (Fly, HashiCorp Vault); ~15h integration + SLA dependency.

SCRUM MASTER
Cap spend and add hard daily/monthly cost ceiling for growth loop (`trending`) batch jobs with fail-closed cutoff.

distillx's competitive moat is the trust/audit wedge (egress ledger, payload transparency), not LLM compute, unbounded volume growth turns a near-zero-marginal-cost engine into a real bill; the roadmap bets on scaling reach via spectator-facing surfaces without a spend governor.

Cost Low mechanical: add a `MaxDailyTokens`/`MaxMonthlySpend` config value and pre-flight check in `trending.Run()` that fails closed; already dedup logic exists in entitlement layer.

Design a queue-backed execution model and multi-tenant job isolation layer before shipping the zero-install hosted web box.

The CPO roadmap bet #3 (launch capped zero-install web box) is critical to close the growth loop and drive promptforce.ai signups, but the current single-process `Runner.Run()` model has no job queue, no credential scoping, no persistence between runs, this is a rewrite, not a config flag.

Cost High: fundamentally different execution shape (queue + worker pool + persistence); requires upfront design now if hosting is committed to, else a late expensive rewrite when traffic exists.

Reconcile distillx's own internal architecture claims with the code via a real tokenizer swap + retrieval index scaling roadmap.

The STRATEGY.md CTO section flags that the chars/4 token estimate and O(n) linear-scan retrieval index are both load-bearing for correctness and silent-failure risks, a customer expecting 10k-file monorepo support will silently over/under-fill the judgment context or hit multi-minute embedding latency; the code's current maxFiles:600 ceiling is undocumented in positioning.

Cost Medium: requires a real tokenizer (vendor a tiktoken-style library or call Claude's tokenizer API) and an ANN structure or on-disk index for retrieval; non-trivial but well-scoped work.

Treat the Idea Catalog itself as a first-class artifact surface: ship a distillx-specific web gallery showing per-idea generality/source/reuse-mode and filtered by use case.

distillx's entire value prop is 'synthesize transferable ideas from repos', yet the output today is a flat markdown report and a ReadyBase scorecard; the Idea Catalog is buried in synthesis and never highlighted as the extractable asset it is. A web gallery of ideas (sortable by generality/transferability/reuse-mode) is a distribution wedge and a direct upsell to the trending spectator audience.

Cost Medium: extends `report/gallery.go` to render ideas as cards (idea title, generality badge, source, reuse mode, sample findings); low wiring, high visibility.

Make 'security audit' (CISO persona) a standalone, marketed product tier with egress ledger transparency and --audit flag as the headline differentiator.

The STRATEGY.md CPO section identifies egress ledger + `--no-source-to-cloud` as 'distillx's actual moat' and the trust/audit wedge for security-conscious teams, but it's buried in a CLI flag and never surfaced as a product story or pricing tier. The trending growth loop drives reach; this is the direct paying ICP.

Cost Low: already built in `internal/egress/egress.go`; cost is marketing/positioning (landing page copy, pricing card, blog post on the ledger) and shallow product work (web UI to download audit CSVs, a 'certification' badge for repos passing CISO scan).

Establish a canonical 'Idea Extraction Standard' (generality/source/reuse-mode taxonomy) and document it as distillx's own philosophy, not just a schema.

The Idea Catalog (Phase 3) is distillx's core innovation, the structured tagging that lets personas and customers filter signal from noise. But the standard (what 'transferable' means vs 'domain-specific', when to mark 'vendor directly' vs 'reimplement') lives only in code. Codifying this as a published reference/playbook would be a thought-leadership asset and a moat-deepening move.

Cost Low: write a 2-3 page spec + examples (e.g., the nirogita-distill catalog is a real corpus); wire into --help and docs.

Split the 6-persona default panel (CTO/CPO/VPE/CISO/Scrum Master/Staff Eng) into configurable 'compact' (3-persona: CTO/CPO/CISO) and 'full' profiles to align cost and use case.

The STRATEGY roadmap notes that lite profile (Haiku + 2 personas) is the default for `trending`, but the code always runs 6+ personas in parallel (`PersonaWorkers` is a global pool). A 'compact' profile for trending/gallery (fast, cheap) vs 'full' for direct paid runs (depth) would align cost to use case and deepen the pricing tier differentiation.

Cost Low: add a config section for `profile: [compact|full]` and a slice of persona IDs; wire into the default config.

Where the panel agrees

  • Isolate each person's data and activity by scope with separate workspaces, files, memory, keychain, and permissions (personas: CTO; CPO; CISO; why: Foundational multi-tenant safety; prevents privilege escalation and cross-user data leakage; single point of control for compliance enforcement)
  • Gate write operations at skill level with prepared mutations before approval (personas: CPO; VPE; why: Audit trail is only trustworthy if mutations are presented before execution; model-level gating is bypassable; mostly already implemented, needs standardization)
  • Deploy with layering (deploy/layers/ keeps core byte-identical) to preserve conflict-free merges (personas: CPO; VPE; why: Enables customer customization without forking; retention engine; requires discipline + pre-commit tooling, not heavy engineering)
  • Materialize credentials into environment variables for shell commands, scoped per sandbox process (personas: CTO; CISO; why: Eliminates credential leakage between concurrent agent runs; removes global state as zero-day vector; scope-bound leaked env vars)
  • Use memory as index only; keep mutable state in workspace files, not memory (personas: CTO; VPE; why: Separates ephemeral index from durable storage; prevents unbounded memory growth as scaling ceiling; prevents cross-scope credential caching)
  • Track token and request budgets with rate limiters to prevent cost overruns (personas: CTO; Scrum Master; why: Operationally critical for SaaS unit economics; prevents runaway costs in multi-agent deployments; hard to retrofit later)
  • Abstract persistence backends (sandbox, session store, model gateway) behind interfaces (personas: CTO; VPE; why: Decouples core from infrastructure; enables 10x scale transitions (SQLite→Postgres→distributed) without core rewiring)
  • Restrict sensitive operations (credential input, sign-in) to direct messages only, never channels (personas: CPO; CISO; why: Bakes audit trail and channel-leakage prevention into UX; prevents cross-user secret exposure in shared channels; already mostly implemented)
  • Require human approval for write operations before executing; screen external data with classifier (personas: CISO; CTO; why: Prevents unauthorized data modifications and supply-chain attacks via agent compromise; prevents model injection from untrusted sources)
  • Delegate credential management to OAuth providers rather than storing or rotating in-house (personas: CTO; CISO; why: Shifts security and compliance burden to audited third parties; eliminates token rotation operations and HSM infrastructure costs)
  • Managed browser sessions with persistent sign-in profiles across agent runs (personas: CPO; VPE; why: Eliminates manual re-login friction; agents sign in once, reuse credentials; requires operator infrastructure choice (Anchor/Kernel/Browserbase))
  • Use one-time secret-drop URLs to collect sensitive credentials without transiting through chat (personas: CISO; why: Prevents secrets from entering chat history, logs, transcript search, or backups; dramatically reduces forensic attack surface)

Tensions

  • Command policy claimed as enforced; code admits sandboxing is bypassable via obfuscation or script-writing (evidence_strength: very_strong; personas_flagging: CTO; CPO; VPE; CISO; severity: critical; why_matters: Security narrative assumes enforcement; code provides no alternative sandbox boundary. Enterprise buyers discover the gap and lose trust. Sandbox is advisory-only; all downstream controls untrustworthy if agent is compromised.)
  • Memory policy ('no secrets') enforced by instruction, not code layer; persistence layer does not redact or prevent secret storage (evidence_strength: strong; personas_flagging: CISO; VPE; severity: critical; why_matters: Secrets can leak into backups, logs, transcript search, and cached sessions. Documentation/implementation mismatch creates false sense of security. When memory is backed up or cross-scope cached, secrets leak.)
  • README claims 'pick your model and harness'; codebase is tightly coupled to Node.js/TypeScript/Fastify (evidence_strength: strong; personas_flagging: CPO; VPE; severity: medium; why_matters: Misleading positioning erodes technical evaluator trust. Scrum Master roadmap assumes single-language platform. Low-cost fix: own the platform bet and clarify 'Node.js-focused' as deliberate, not aspirational.)
  • Design templates claim 'self-contained HTML output' but substitute proprietary/CDN fonts (Google Fonts links) (evidence_strength: medium; personas_flagging: CPO (inferred); severity: low; why_matters: External font fetches create privacy/tracking risk and supply-chain audit liability. CISO would flag CDN dependencies as out-of-scope. Low-cost fix: convert to local woff2 or system fonts.)

Scorecard (the depth, if you want it)

62
Architecture

Strong foundational patterns: scope-based isolation, approval gates, credential scoping, dependency injection, and abstract persistence backends (src/wiring.ts). However, significant coupling to Node.js/TypeScript/Fastify limits platform flexibility. Single-process execution with no job queue or skill isolation layer; skills are in-process and fail-hard into orchestrator. Memory abstraction not enforced at code layer. Will age well for small-team deployments but becomes a bottleneck for multi-tenant scale without architectural rewrites.

48
Maturity

Core infrastructure deployable (Fly/AWS templates, test suites exist), but production-readiness gaps are material. No CI/CD gating on tests (VPE: 'orchestrator changes ship untested'). No hard cost ceilings for multi-agent deployments (Scrum Master: will lead to surprise bills at scale). Single-process runner with no persistent job queue (required for hosted multi-tenant). Security gaps documented but unremediatied (bypassable sandboxing, no memory redaction enforcement). Missing operational patterns: skill isolation, resource limits, crash recovery. Suitable for internal/alpha deployments, not for cost-sensitive or untrusted-tenant workloads.

32
Security

Critical gap between design and enforcement: SECURITY.md itself admits command policy is bypassable via obfuscation or script-writing, and memory redaction is enforced by instruction, not code layer. Scope isolation, approval gates, and credential materialization are well-designed, but sandbox is advisory-only. Memory can leak secrets to backups/logs/cross-scope caching. No technical enforcement of authorization at resource level (CISO: 'policies relying only on model instructions fail when agent is compromised'). Design templates use CDN fonts (supply-chain risk). Suitable for internal/trusted deployments; unsuitable for risk-averse enterprises or multi-tenant SaaS.

58
Reusability

Core patterns are conceptually reusable (scope isolation, approval gates, credential scoping all score 8/10 generality per synthesis). Deploy/layers approach is portable for customization without forking. However, platform coupling to Node/TypeScript/Fastify limits practical vendoring to Node teams. Skills are in-process, not independently versioned. Design templates (54 systems) are reusable but use CDN dependencies instead of self-contained. No documented abstraction boundaries for swapping job queue or session store implementations. Patterns can be stolen; platform cannot easily be forked or adapted to other tech stacks.

42
Documentation

Mixed quality. Strengths: SECURITY.md is admirably honest about limitations; CLAUDE.md and CONTRIBUTING.md provide process guidance; deployment templates (fly.md, aws.md) are thorough. Weaknesses: README overstates flexibility ('pick your model and harness' vs Node/TypeScript-only code; tension flagged by CPO/VPE). Scalability limits undocumented (maxFiles:600 ceiling per Scrum Master). No documented entry point for contributors. Design templates claim 'self-contained HTML' but substitute CDN fonts (misleading). ReadyBase's score of 15 reflects freshness; content is partially aspirational on core capabilities.

23
Testing

Tests exist (test/orchestrator.test.ts, cli/test/e2e/, cli/test/aws.test.ts) but are not integrated into CI/CD enforcement. No GitHub Actions workflow to gate test passage before merge (CI/CD score 10 suggests partial automation). Missing coverage for critical paths: credential scope leakage, memory redaction, egress transparency (VPE: 'no tests found for internal/claude or internal/egress'). ReadyBase's 'Test quality: 0' reflects insufficient coverage despite test files existing. Testing culture present but enforcement weak; regressions can ship untested.

Borrowing from this repo

target: understand this repo's architecture and extract reusable patterns
CallIdea & reasoningCost
adapt
Restrict sensitive operations to DM-only; prevent credential input and sign-in in channels or groups

Pattern is context-aware permission gating; DM-only is one instantiation, not the core abstraction

2h to extract abstraction; 4h per new context type
adopt
Clarify README: frame Node.js/TypeScript/Fastify coupling as deliberate platform bet, not aspirational flexibility

Unblocks architecture comprehension; prevents evaluators from misreading as flexible multi-runtime system

0.5h doc rewrite
adopt
Deploy with layering (deploy/layers/ keeps core byte-identical) and pre-commit hook to prevent secret leakage

Concrete, transferable pattern for org customization without core drift; enables conflict-free upgrades

3h document + validate
adopt
Gate write operations at skill level with prepared mutations and explicit approval before execution

Foundational safety pattern; unifies audit trail and consent; mostly implemented, needs standardization

4h standardize 20 skills
adopt
Track token and request budgets with rate limiters and advisory locks to prevent SaaS cost overruns

Operationally critical pattern; hard to retrofit once traffic scales; high transferability

5h instrument external calls
adopt
Materialize credentials into environment variables for shell commands, scoped per sandbox process

Eliminates global state as attack vector; process isolation is the reusable architectural principle

3.5h document + audit implementation
adopt
Use OAuth to delegate credential management to third-party providers rather than in-house token rotation

Shifts compliance burden to audited providers; removes operational complexity; high transferability

2.5h document pattern + integration points
adopt
Isolate each person's data and activity by scope with separate workspaces, files, memory, keychain, and permissions

Foundational architectural principle; all isolation patterns (DM-only, scoped creds, keychain) flow from this

7h document as unified pattern + audit boundaries

Start with README (0.5h) to unblock understanding. Immediately document scope-isolation as foundational architecture (7h), this is the load-bearing insight that makes all derivative patterns coherent. Then serialize concrete patterns: layering (3h), write-gating (4h), credential materialization (3.5h), OAuth (2.5h), budget tracking (5h). Do this over 2-3 weeks in parallel code reviews and doc passes. Biggest risk: treating DM-only restrictions, scoped env vars, and permission gating as ad-hoc safety tactics instead of surface manifestations of unified scope isolation. If scope isolation is not documented first and centered, the pattern catalog will appear duplicative and context-specific, losing transferability.

ReadyBase raw signals+
Documentation · README 2 days old15
Test coverage · 50% test presence (proxy, set READYBASE_ALLOW_EXEC for real coverage)10
Test quality · no tests found0
CI/CD · CI: tests=true lint=true deploy=true10
Complexity · max 4287 lines/file, 5% of files >800L (53/1027), 935 funcs>503
Build · 27 env vars, docker=false, ci=true4
Dependencies · no dependencies15
Bus factor · 1 unique committers0
Structure · 72 packages, avg depth 2.35
Method & data egress+
Local · Ollama239395 in / 16708 out · 264 calls
Cloud · Claude1153420 in / 54139 out · 10 calls · $1.4492
Contact us if you want to run this on your repo → Local, no-telemetry binary, your code never leaves your machine.