spec-suite-skill

Abdiel49 — Tue, 18 Aug 2026 04:05:48 +0000

Why I Built Spec Suite: Putting an End to Hallucinated AI Documentation

Let's be honest about the current state of AI-assisted software planning: we've all tried asking a Large Language Model (LLM) or a CLI agent to write a "Technical Requirements Document" or a "Terms of Service" policy. We paste a massive prompt, cross our fingers, and wait.

The result? Usually, it's a generic wall of text. The AI invents database paradigms you don’t use, ignores your specific user roles, and if you ask for a legal policy, it completely forgets to include the mandatory liability disclaimers.

I got tired of wrestling with these "hallucinations" and spending more time fixing AI-generated documents than it would take to write them from scratch. That frustration led to the creation of Spec Suite.

The Core Problem: Lack of Contextual Discipline

LLMs are incredibly smart, but they lack discipline. If you ask an autonomous agent to build a Security Threat Model, it will gladly oblige by guessing your architecture.

To fix this, we don't need better prompts; we need a structured prompt ecosystem. Agents need to understand that documentation is a dependency graph. You cannot write a Security Plan without first establishing the System Architecture (TRD) and the Database Schema. You cannot write a Data Processing Policy without knowing the jurisdictions you operate in.

Enter Spec Suite

Spec Suite is an open-source orchestration skill designed specifically for autonomous AI agents (like Claude Code, Antigravity, Cursor, etc.). Instead of giving the AI loose instructions, Spec Suite teaches your agent to behave like a methodical Senior Software Architect and a rigorous Compliance Expert.

It achieves this by dividing project documentation into two distinct, interconnected tracks:

💻 Track A: The Technical Specs

This track focuses on the engineering blueprints. It guides the AI to produce:

PRD (Product Requirements Document)
TRD (Technical Requirements Document & Architecture)
Backend Schema (Database ERDs and indexing strategies)
App Flow (User journeys and event-driven system flows)
UI/UX Brief (Information architecture and accessibility rules)
Implementation Plan (Phased delivery and risk registries)
Security Plan (Threat modeling and defense-in-depth)

⚖️ Track B: The Legal & Policy Suite

This track focuses on compliance and operations. The agent acts as a policy drafter, always enforcing mandatory "Structural Draft" disclaimers:

Legal Compliance Annex (Jurisdictional mapping)
Terms of Service (T&C)
Privacy Policy (PII handling and user rights)
Data Processing Policy (Data lifecycles and vendor mapping)
Acceptable Use Policy (Content moderation and enforcement)
Content & Image Use Policy (Copyright and UGC rules)
AI Use Policy (Governance for algorithmic decision-making)
Disclaimer & Continuity (SLAs and warranties)

The Magic: Prerequisite Chaining

What makes Spec Suite powerful isn't just the markdown templates; it's how the AI is instructed to use them.

Embedded within the skill is a strict set of prerequisite rules. If you tell your agent, "Generate a Security Plan", the agent is programmed to stop and verify its context. It will essentially tell you: "Wait, I cannot write a Security Plan without first reading your TRD and Backend Schema."

If those documents don't exist in your project yet, the agent will offer to generate them first. This prerequisite chaining forces the LLM to anchor its outputs to established facts about your project, drastically reducing hallucinations. The resulting documents are highly cohesive because the AI is literally building on its own validated context.

Lightning-Fast Sub-Module Routing

You don't always need to generate a massive 15-document suite. Sometimes you're just hacking in your terminal and realize you need a quick database schema for a new feature.

Spec Suite includes an alias-based sub-module routing system. You can simply tell your agent:
Execute spec-suite:schema for this feature

The agent bypasses the master orchestrator, reads the specific guidelines for database schemas, asks you for the target output directory, and generates exactly what you need in seconds.

Try It In Your Project

I've made Spec Suite completely Open Source (MIT License). If you are using NPM-compatible autonomous agents, you can install it globally or inject it directly into your current workspace with a single command:

npx @abdiel49/spec-suite-skill

The next time you start a new project, try telling your agent: "Generate the full spec suite for this idea." Grab a coffee, and watch it meticulously orchestrate your entire technical and legal foundation.

If Spec Suite saves you hours of documentation headaches (like it has for me), consider giving it a star on GitHub or reaching out on Twitter to share your experience. Happy coding!

Configure Cloudflare Email Routing with Gmail to Send and Receive Mails

Abdiel49 — Tue, 12 May 2026 16:11:49 +0000

Configure Cloudflare Email Routing

Open: https://dash.cloudflare.com and go to Email → Email Routing, enable Email Routing and create your custom address.

Example:

user@yourdomain.com
→ forwards to
yourgmail@gmail.com

Cloudflare will send a verification email to your Gmail account to confirm the forwarding destination. Open the email and verify it.

Enable Gmail App Passwords

Open https://myaccount.google.com/security and enable 2-Step Verification, then open: https://myaccount.google.com/apppasswords and generate a new App Password for Mail.

Google will generate a password similar to:

abcd efgh ijkl mnop

This will be your SMTP password.

Configure Gmail to Send Emails Using Your Domain

In Gmail go to:

Settings → See all settings → Accounts and Import → Send mail as → Add another email address.

Add: user@yourdomain.com

Use this SMTP configuration:

SMTP Server: smtp.gmail.com
Port: 587
Username: yourgmail@gmail.com
Password: YOUR_APP_PASSWORD
TLS: Enabled

Verify the Custom Domain Email

Gmail will send a verification email to: user@yourdomain.com
Cloudflare will forward it to your Gmail inbox automatically.
Open the email and confirm the verification.
Refresh Gmail, now you can send emails as: user@yourdomain.com

Configure SPF and DMARC

Add these DNS TXT records in Cloudflare.

SPF

Host: @
Value: v=spf1 include:_spf.google.com ~all

DMARC

Host: _dmarc
Value: v=DMARC1; p=quarantine;

DEV Community: Abdiel49