[Meta] Viral OSS Readiness Initiative

[justsml]

Overview

This is a meta-issue tracking the full Viral OSS Readiness initiative. The goal is to transform Agent Security from a well-architected private workspace into a credible, discoverable, and contribution-friendly open-source project.

Background

A forensic audit revealed the following:

• Technical depth: 8/10 — Strong Mastra integration, approval model, Render JSON pattern, 41 test files
• OSS packaging: 4/10 — Missing community files, no CI/CD, weak README storytelling, no Docker deployment, monolithic frontend

Tier 1: Launch Blockers (Do This Week)

These are the minimum viable surface area for a credible OSS project.

#	Issue	Status
1	Add Dockerfile + publish to GitHub Container Registry	Open
2	Add pnpm db:seed with demo project for first-run aha moment	Open
3	Add pnpm setup validation script	Open
4	Create docs/architecture.md with diagram	Open
5	Decompose ChatWorkspace.tsx (2,960-line monolith)	Open

Tier 2: Growth Accelerators (Do This Month)

These drive stars, forks, and contributor funnel.

#	Issue	Status
6	Create 60-second demo GIF/video	Open
7	Write docs/getting-started.md tutorial	Open
8	Add CHANGELOG.md	Open
9	Enable GitHub Discussions + link in README	Open
10	Curate 5–10 good first issue items	Open
11	Add ESLint + Prettier configs	Open
12	Add end-to-end smoke test	Open

Tier 3: Virality Polish (Ongoing)

These are the optimizations that turn a good project into a viral one.

#	Issue	Status
13	Submit to awesome-mastra / awesome-security lists	Open
14	Write Hacker News "Show HN" launch post	Open
15	Add model provider abstraction (Azure, Anthropic, Ollama)	Open
16	Add tool plugin manifest system	Open
17	Create logo / brand identity	Open
18	Add "Used By" testimonials section	Open

Already Completed (Audit Additions)

• Added LICENSE (MIT)
• Added SECURITY.md
• Added CODE_OF_CONDUCT.md
• Added CONTRIBUTING.md
• Added .github/workflows/ci.yml
• Added .github/ISSUE_TEMPLATE/bug_report.yml
• Added .github/ISSUE_TEMPLATE/feature_request.yml
• Added .github/PULL_REQUEST_TEMPLATE.md
• Rewrote README.md with badges, Quick Start, features, comparison table, screenshots

How to Help

Pick an issue from the tier that matches your skills and bandwidth. Comment on the issue before starting work to avoid duplication. See CONTRIBUTING.md for setup instructions.

Labels

documentation, infrastructure, dx, help wanted

[justsml]

Status Update: First Pass Complete

✅ Closed (12 of 18 tickets)

Tier 1 (5/5): #2 Dockerfile, #3 db:seed, #4 setup, #5 architecture docs, #9 changelog
Tier 2 (4/7): #8 getting-started tutorial, #12 ESLint+Prettier, #13 smoke test, #15 launch posts
Tier 3 (3/6): #14 awesome lists (deferred), #18 logo, #19 testimonials

⏳ Remaining

#	Tier	Title	Reason
#6	1	Decompose ChatWorkspace.tsx	Large refactor, needs dedicated pass
#7	2	Create demo GIF/video	Requires screen recording tools
#10	2	Enable GitHub Discussions	Requires repo admin settings
#11	2	Curate good first issues	Needs manual review of codebase
#14	3	Submit to awesome lists	External PRs, deferred
#16	3	Model provider abstraction	Architectural change, needs design
#17	3	Tool plugin manifest system	Architectural change, needs design

Files Created (22 new files)

• .github/workflows/release.yml — GHCR Docker publication
• Dockerfile — Multi-stage production build
• eslint.config.mjs, .prettierrc — Code quality config
• CHANGELOG.md — Release history
• docs/architecture.md — System architecture guide
• docs/getting-started.md — Tutorial
• docs/launch/*.md — HN, Twitter, LinkedIn drafts
• public/logo.svg — Brand identity
• scripts/setup.ts — Environment validation
• scripts/db-seed.ts — Demo project seed
• src/app/api/health/route.ts — Health endpoint
• tests/e2e/smoke.test.ts — E2E smoke tests

[justsml]

Status Update: Second Wave Complete

✅ Newly Closed (2 tickets)

#	Tier	Title	What was done
6	1	Decompose ChatWorkspace.tsx	2,960→823 lines, 12 extracted files in src/components/chat/
7	2	Create demo GIF/video	Remotion project in video/ with 7 scenes (30s)

⏳ Remaining (5 open issues)

#	Tier	Title	Why not done
10	2	Enable GitHub Discussions	Needs repo admin settings
11	2	Curate good first issues	Needs manual review
14	3	Submit to awesome lists	External PRs
16	3	Model provider abstraction	Architectural change
17	3	Tool plugin manifest system	Architectural change

Decomposition impact

• ChatWorkspace.tsx: 72% smaller (823 lines vs 2,960)
• 12 new focused components in src/components/chat/
• All 177 tests pass, typecheck clean