Improvement Plan

Enter the access code to continue.

ORIGINAL 42-ITEM PLAN — 2026-03-18 — This is a historical snapshot. View all archived reports
← Back to Deliveries

AaaS Ecosystem — Comprehensive Improvement Plan

Generated: 2026-03-18 | Updated: 2026-03-20 (full system scan + repo reorganization + cron fixes) | Scope: 17 managed repos, 5 domains, 12 Cloud Functions

System Scan — 2026-03-20

5/5
Domains UP
17
Managed Repos
1,276
Blog Entities
3
Function Errors
6/7
Crons Healthy

Infrastructure Actions Completed Today

StActionImpact
GitHub repo reorganization — 8 repos renamed (lowercase + naming convention: . = domain, - = no domain). All remotes updated.Consistent naming across ecosystem
Visibility audit — Made Bloolai-V0.1 + sb1-bafmj1 private. Only aaas-vault remains public.Security posture improved
Repo metadata enrichment — All 28 repos now have descriptions, topics, and homepage URLs.Discoverable by humans + agents
Reference updates — 37 files across 18 directories updated with new repo names.No stale references in configs
Daily Operations Brief fix — Fixed FileNotFoundError: firebase by using absolute paths in all cron-executed scripts.Daily brief now generates correctly
Expanded supervision scope — Updated KNOWN_PROJECTS in health check + review pipeline from 4-8 projects to 11-12.Full ecosystem visibility
CLAUDE.md repo inventory — Added complete GitHub Repository Inventory with managed/read-only tiers.Clear scope boundaries for agents
Deployment fix — Fixed aaas.com monorepo remote (was pointing to wrong repo after rename).Deployments unblocked

Open Items Requiring Attention

#IssuePriorityOwner
S.12 Cloud Function scheduler errors — Root cause: error logging too sparse + likely missing RESEND_API_KEY. Error logging enhanced with stack traces. Next failures will show full context.MEDIUMSupervisor
S.2Monday crons untested — Context sync + infrastructure review crons (added 03-19) haven't run yet. First run: Mon 03-23.LOWWait
S.3GCP billing alert not configured — $200/mo budget alert needs manual creation in Cloud Console.HIGHHuman
S.4GCP APIs for aaas.diy — External provider setup blocked (ibossyNr1/tasks#2)HIGHHuman
S.5No automated social posting — Content pipeline produces entities but no LinkedIn/X distribution.HIGHSupervisor
S.612 repos with uncommitted changes — From today's rename session. Need batch commit.MEDIUMSupervisor

Executive Summary

The AaaS ecosystem spans 5 deployed domains, 17 managed repos, 12 Cloud Functions, 1,276 blog entities, and a 7-cron automation layer — all serving a single goal: continuous automated market exposure so businesses discover AaaS and start using it.

42
Original Items ✅
8
Infra Actions ✅
6
Open Items

The original 42-item improvement plan is 100% complete. Today's system scan added 8 infrastructure actions (all completed) and identified 6 open items (2 human-blocked, 4 autonomous).

SEGMENT 1: aaas.blog — Knowledge Index & Content Engine

Domain: https://aaas.blog

Role: SEO-driven inbound traffic engine. Every entity page is a search landing page.

Current: 11 entity types, 10 channels, 288 toolbox templates, 34 self-healing agents

What's Working

Missing / Broken

St#IssuePriorityImpactEffort
1.1**GravityClaw → Blog sync is one-way (audio only)** — Blog posts composed by GravityClaw publisher pipeline are written to `/blog-posts/` but not auto-published to Firestore entities. The aaas-sync bridge only syncs podcast audio, not blog articles.HIGHContent created by GravityClaw never appears on aaas.blogM
1.2**Blog build fails during SSG** — `generateStaticParams` for `/dataset/[slug]` hits Firestore permissions error during build. Blocks redeployment.HIGHCannot redeploy blog with code changesS
1.3**RSS/Atom feeds** — 4 feed types deployed: main feed, entity changelog, podcast, and following feed. (Confirmed 2026-03-19)MEDIUMContent distribution channel activeS
1.4**Toolbox in blog nav** — Desktop + mobile + dropdown links to /docs with "288 templates" badge. (Confirmed 2026-03-19)MEDIUMToolbox accessible from blogS
1.5**Trending page** — Full `/trending` page with top-3 podium, type filtering, sparklines, grade badges. (Confirmed 2026-03-19)MEDIUMHigh-engagement page liveS
1.6**Entity pages lack CTA to platform** — Entity detail pages don't prompt visitors to sign up for AaaS. Every page view is a missed conversion opportunity.HIGHZero conversion on organic trafficS
1.7**Comparison pages** — Full `/compare` landing + `/compare/[...slugs]` detail with side-by-side scores, Venn diagrams, winner highlighting. (Confirmed 2026-03-19)MEDIUMHigh-value SEO pages liveM
1.8**Subscriber onboarding doesn't connect to platform** — Blog subscribers exist in a separate `subscribers` collection. No bridge to create a platform account.HIGHTwo disconnected user poolsM
1.9**No automated social posting** — Content is discovered and enriched but never posted to LinkedIn, Twitter/X, or other channels automatically.HIGHNo amplification of contentL
1.10**Entity types filled** — framework, platform, startup, use-case types added with 5 entities each. Daily cron generates 5 more/day. (Built 2026-03-19)MEDIUMAll entity types populatedM

Recommended New Entity Types for aaas.blog

TypeExample EntitiesSEO Value
`framework`LangChain, CrewAI, AutoGen, Semantic KernelVery High — "X vs Y" searches
`platform`Vertex AI, Azure AI, AWS Bedrock, ReplicateHigh — enterprise buyer searches
`startup`Anthropic, Mistral, Cohere, AI21High — investor/founder searches
`course`DeepLearning.AI, Fast.ai, Stanford CS224NMedium — learning intent
`newsletter`The Batch, AI News, Import AIMedium — discovery intent
`use-case`RAG, Code Review, Customer Support AIVery High — buying intent

SEGMENT 2: aaas.name — Acquisition Funnel

Domain: https://aaas.name

Role: Primary marketing landing page. Convert visitors → email signups → platform users.

Current: Hero + 3-step explainer + agent directory + toolbox preview + 4 email CTAs

What's Working

Missing / Improvements

St#IssuePriorityImpactEffort
2.1**PostHog analytics deployed** — Provider on both platform + name apps, 7 funnel events, UTM capture. Activates when NEXT_PUBLIC_POSTHOG_KEY is set. (Built 2026-03-19)HIGHFunnel tracking readyS
2.2**No social proof** — No testimonials, user count, company logos, or trust signals.HIGHLow conversion trustS
2.3**No video/demo** — No explainer video showing AaaS in action. The email-to-agent workflow is hard to visualize from text alone.MEDIUMUnclear value propositionM
2.4**Agent live stats built** — agent-live-stats.tsx (353 lines) fetches real Firestore data: trust score, tasks completed, success rate, last active, status color. (Confirmed 2026-03-19)MEDIUMAgents show real dataM
2.5**Pricing section deployed** — 3-tier pricing cards (Starter free, Professional $49/mo, Enterprise custom) on aaas.name landing page. (Built 2026-03-19)MEDIUMPricing visible before click-throughS
2.6**Email signup doesn't trigger platform onboarding** — Firestore `subscribers` doc is created but no Cloud Function bridges to `users` collection for the context pipeline.HIGHSignup → nothing happensM
2.7**No retargeting/remarketing pixel** — No Facebook Pixel, LinkedIn Insight, or Google Ads tag.LOWCan't retarget visitorsS

SEGMENT 3: agents-as-a-service.com — Platform & Dashboard

Domain: https://agents-as-a-service.com

Role: Main website + authenticated dashboard (select module). Where users manage agents, view context, send tasks.

Current: 10 pages, 10 dashboard modules, 5-step onboarding, context pipeline integration

What's Working

Missing / Improvements

St#IssuePriorityImpactEffort
3.1**Agent task execution is email-only** — The "Send Task" button opens a mailto: link. No in-platform task submission or tracking.HIGHCore feature feels unfinishedL
3.2**No task history/results view** — Users can't see past tasks, their status, or results in the dashboard.HIGHNo feedback loopM
3.3**Billing module is placeholder** — Shows Stripe test links (`buy.stripe.com/test_xxx`). No real payment integration.HIGHCan't monetizeL (Human)
3.4**Notification system deployed** — Bell icon + dropdown in dashboard top bar, Firestore real-time listener, unread badge, mark-as-read. (Built 2026-03-19)MEDIUMReal-time awareness activeM
3.5**Support module built** — Full form submission to Firestore support_tickets, success states, clear form flow. (Confirmed 2026-03-19)MEDIUMUsers can reach supportS
3.6**Usage metrics dashboard built** — 351-line dashboard with counts, timeline, agent breakdown from email_logs + agent_tasks + context_pipelines. (Confirmed 2026-03-19)MEDIUMUsers see real usage dataM
3.7**Vault skill activation deployed** — Activate/deactivate toggle, Firestore subcollection, visual active state (green border + badge), active count. (Built 2026-03-19)MEDIUMSkills are actionableM
3.8**Agent status indicators enhanced** — 4-level status dots (green/yellow/red/gray) with hover tooltips, status summary bar in agents module header. (Enhanced 2026-03-19)LOWSystem state visibleS

SEGMENT 4: Cloud Functions — Email & Pipeline Infrastructure

Role: Event-driven automation backbone. Context generation, email drip, subscriber digests.

Current: 9 functions (context pipeline, email triggers/scheduler, subscriber digests, TTS, webhook)

What's Working

Missing / Improvements

St#IssuePriorityImpactEffort
4.1**RESEND_API_KEY not configured** — Email system is deployed but won't send without the API key set as a Cloud Functions secret.CRITICALEntire email system is deadS (Human)
4.2**Structured JSON logging deployed** — All 22 Cloud Functions migrated to createLogger() with severity, timestamps, structured data. Deployed to production. (Built + deployed 2026-03-19)MEDIUMCloud Logging compatibleS
4.3**Manifest cached in Firestore** — skill-matcher.ts caches to system_cache collection with 24h TTL, fire-and-forget writes. (Confirmed 2026-03-19)LOWCached, no GitHub rate limit riskS
4.4**Retry mechanism built** — Exponential backoff (1s→4s→16s), 3 retries, permanent failure detection for validation errors, structured logging. (Confirmed 2026-03-19)MEDIUMTransient failures auto-retryM
4.5**TTS function is stubbed** — Works on GCP but fails locally. Not critical for MVP.LOWNo audio generation from platformS
4.6**No admin notification function** — When a new user signs up or context pipeline completes, the AaaS team isn't notified.MEDIUMTeam misses conversion eventsS
4.7**Context functions by design** — contextPipeline (watches context_pipelines/) and generateContextPackage (watches context_packages/) serve different entry points. Not duplicates. (Verified 2026-03-19)LOWIntentional separation confirmedS

SEGMENT 5: GravityClaw → Blog Content Pipeline

Role: Discovers innovations, composes narratives, publishes to blog. The content generation engine.

Current: Intake (multi-source discovery) → Publisher (LLM composition) → AaaS Sync (audio only)

What's Working

Missing / Improvements

St#IssuePriorityImpactEffort
5.1**Blog posts don't sync to aaas.blog** — Publisher writes markdown to `/blog-posts/` directory but no function publishes them to Firestore. The sync bridge only handles audio.CRITICALGravityClaw's main output is invisibleM
5.2**Automated entity generation** — Daily cron at 10:30 generates 5 entities for thinnest blog types via Gemini API + quality gate. 1,251→1,271 entities. (Built 2026-03-19)HIGHContent production automatedM
5.3**No social media distribution** — Published content isn't automatically shared to LinkedIn, Twitter/X, or other channels.HIGHZero amplificationL
5.4**Publisher dedup only checks date** — Prevents same-day republish but doesn't prevent topically similar posts.LOWPotential content redundancyS
5.5**Content quality gate built** — 7 validation checks: required fields, slug format, description length, score ranges, tag minimums, hallucination detection. (Built 2026-03-19)MEDIUMQuality-gated content onlyM

SEGMENT 6: Autoresearch Fleet (Agent Orchestrator)

Role: Daily automated research across 5 departments. Updates knowledge base, feeds blog channels.

Current: 12 agents in 5 groups (research, content, sales, engineering, strategy), daily GitHub Actions

What's Working

Missing / Improvements

St#IssuePriorityImpactEffort
6.1**Research → Blog entity pipeline is disconnected** — Agents update `knowledge/synthesis.md` files but don't create Firestore entity submissions. The research is stranded in git.CRITICALResearch never becomes searchable contentM
6.2**No sales agent execution** — Outbound Strategist and Email Specialist are listed but have no outreach infrastructure (no email sending, no prospect database).HIGHSales department is theoreticalL
6.3**Execution log tab deployed** — "Execution Log" tab in agents module with real-time agent_logs feed, status dots, relative timestamps, error messages. (Built 2026-03-19)MEDIUMAgent execution visible in dashboardS
6.4**No feedback loop** — Agents don't learn from which content performs well. No engagement metrics flow back to research priorities.MEDIUMContent quality doesn't improveL

SEGMENT 7: Cross-Platform Integration & UX

Missing / Improvements

St#IssuePriorityImpactEffort
7.1**No unified user identity** — Blog subscribers, platform users, and vault profiles are separate collections. A user who subscribes on aaas.blog and signs up on agents-as-a-service.com has two unlinked records.HIGHFragmented user experienceL
7.2**No cross-domain auth** — Signing in on agents-as-a-service.com doesn't recognize you on aaas.blog or aaas.name.HIGHMust sign in separately per domainM
7.3**aaas.select redirects to platform** — The select app is just a redirect. Either build it out as a workspace selector or remove it entirely.LOWConfusing dead appS
7.4**No unified search** — Can't search across agents, skills, tools, and blog content from a single search bar.MEDIUMFragmented discoveryM
7.5**No mobile app or PWA** — Platform is web-only. Adding PWA manifest + service worker would enable mobile engagement.LOWMissing mobile channelM

SEGMENT 8: Market Exposure & Growth Engine

Missing / Improvements

St#IssuePriorityImpactEffort
8.1**No LinkedIn automation** — AI ecosystem content should be auto-posted to LinkedIn company page and personal profiles. This is the #1 channel for B2B SaaS.HIGHMissing primary distribution channelM
8.2**No Twitter/X bot** — Auto-tweet new entity discoveries, trending tools, and agent capabilities.MEDIUMMissing real-time social presenceM
8.3**No email course / lead magnet** — "5-Day AI Automation Crash Course" type drip sequence for top-of-funnel education.HIGHNo education-to-conversion funnelM
8.4**No referral program** — Existing users can't invite others. No viral loop.MEDIUMLinear growth onlyM
8.5**No case studies** — No published results from real agent tasks. Social proof is critical for B2B.HIGHNo proof of valueS (content)
8.6**Full SEO metadata deployed** — og:image, twitter cards, keywords, JSON-LD (Organization + WebSite + SearchAction), sitemap (6→11 routes), robots, per-route metadata. (Built 2026-03-19)MEDIUMAll pages SEO-optimizedS
8.7**Interactive demo built** — 346-line live chat widget on aaas.name connected to demoChat Cloud Function. Visitors can interact with AI agent before signup. (Confirmed 2026-03-19)HIGHTry-before-signup experienceL

Priority Matrix — Top 15 Actions

RankIssueSegmentImpactEffort
14.1 RESEND_API_KEY configurationFunctionsCRITICALHuman
25.1 GravityClaw blog post → Firestore syncGravityClawCRITICALAuto
36.1 Research → Blog entity pipelineAutoresearchCRITICALAuto
41.6 Entity pages: add platform CTABlogHIGHAuto
52.6 Email signup → platform bridgeNameHIGHAuto
61.8 Subscriber → platform account bridgeBlogHIGHAuto
71.2 Blog SSG build fixBlogHIGHAuto
83.1 In-platform task submissionPlatformHIGHAuto
98.1 LinkedIn auto-postingGrowthHIGHAuto
108.3 Email lead magnet courseGrowthHIGHAuto
112.2 Social proof on landing pageNameHIGHAuto
123.2 Task history/results viewPlatformHIGHAuto
138.5 Case studies pageGrowthHIGHAuto (content)
147.1 Unified user identityCross-platformHIGHAuto
152.1 Analytics trackingNameHIGHAuto

Implementation Phases

Phase A: Activate Email System (Human Required)

Goal: Get the email drip campaign running

Phase B: Connect the Content Pipeline (Autonomous)

Goal: GravityClaw discoveries → aaas.blog entities → social distribution

Phase C: Close the Funnel (Autonomous)

Goal: Every touchpoint leads to platform signup

Phase D: Amplify Reach (Autonomous + Human)

Goal: Automated market exposure

Phase E: Unify Experience (Autonomous)

Goal: One identity, one search, one experience

Metrics to Track

MetricSourceTarget
Blog organic trafficPostHog/GA410K monthly visitors
Entity countFirestore1,000 entities (currently 1,276 — +35/week via cron)
Email subscribersFirestore subscribers500 active subscribers
Platform signupsFirestore users100 business accounts
Context packages generatedFirestore context_pipelines50 completed
Tasks sent to agentsFirestore agent_tasks200 tasks/month
Email drip completion rateemail_logs40% reach stage 5+
Blog → platform conversionAnalytics5% of blog visitors
LinkedIn engagementLinkedIn API50 interactions/week

This plan is a living document. Update as items are completed or priorities shift.