Skip to content
cccskills
FreePublished on GitHub

goal-and-brief

Establish project thesis before first code. Infer product type from domain/folder/README. Identify users, business model, pSEO strategy, AI-native dev approach. Maintain PROJECT_BRIEF.md as source of truth.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (1)

  • SKILL.md3.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

02 — Goal and Brief

Establish the project thesis and maintain PROJECT_BRIEF.md as the source of truth before any code is written.

Run FIRST on every new project / rebuild

Before code, write PROJECT_BRIEF.md. The brief drives every downstream decision (skill 05 stack, skill 06 build, skill 09 brand, skill 16 site mode).

One-line website prompt? Hand off after the brief: 16-cinematic-website-prime-directive is the prime directive (trumps generic 06-build); website-build-manifest is the acceptance index of every gate; website-build-doctrine is the Phase -1→8 sequence. Brief → manifest → doctrine → build.

Org-type inference (drives everything)

Detect from domain + folder name + scraped homepage + Google Places category:

PatternOrg type
*.com w/ pricing page + signup →saas
*.org w/ donate button + 501(c)(3) →nonprofit
Google Places category in {restaurant, salon, medical, legal, fitness, automotive, retail, photography, real-estate, education, financial, pet, wedding} →local-business
*.com portfolio of links + bio + projects →portfolio
*.gov / .gov.uk / .ca.gov →government
*.edu / *.ac.uk →edu
*.church / parish JSON-LD →church
ProductHunt / G2 / Capterra listing →saas

Output: _org_type.json = {type, confidence, evidence[]}.

PROJECT_BRIEF.md (source of truth)

# {Project Name}

## Thesis
One sentence: what this project does + for whom + why now.

## Org type
{saas | nonprofit | local-business | portfolio | edu | gov | church}

## Primary user
- Persona: {role + context}
- Job to be done: {task they're trying to accomplish}
- Success metric: {what "done" looks like for them}

## Business model
- Revenue: {subscription / donation / one-time / B2B / B2C / ads}
- Pricing: {tier list w/ values}
- Margins: {high / medium / low + rationale}

## pSEO strategy (5 types)
- Integration pages (`/integrations/{tool}`) — Y/N
- Comparison (`/compare/{a}-vs-{b}`) — Y/N
- Use-case (`/for/{audience}`) — Y/N
- Template (`/templates/{type}`) — Y/N
- Location (`/{city}-{service}`) — Y/N

## AI-native development approach
- AI-first features: {list}
- Workers AI / Llama 4 Scout for first-pass content
- Opus 4.8 for top-10 conversion polish
- AI vision QA on every visual surface

## Constraints
- Budget
- Timeline
- Compliance (HIPAA / SOC 2 / GDPR / FERPA / ADA)
- Localization needs (`_kernel/standards.md` § ADA + `rules/i18n-by-demographics.md`)

## Decision log
{Every architectural decision + rationale + alternatives considered}

Question discipline

  • Before code, scan brief for gaps. Use AskUserQuestion ONLY for genuinely unresolvable items (e.g., bilingual-staff confirmation, NAP verification, license number).
  • Per brian-preferences.md: pick ONE answer when inferable, never offer options.
  • Silence = approval.

What this skill produces

  • PROJECT_BRIEF.md — committed
  • _org_type.json — input to skill 05 (stack) + skill 09 (brand) + skill 16 (site mode)
  • _brief_summary.txt — 100-word digest for downstream agents

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Every delivered app — the non-inferable business requirements + exact stack/brand choices every build must satisfy. Loads on every app/site build.

The English summary is being prepared. Showing the original description.

heymegabyte/agent-skills24Updated Oct 11, 2026

Cloudflare-first platform selection. Decision trees for Workers, D1, R2, KV, DO, Queues, Vectorize, Containers, Sandboxes, Flagship, Agent Memory, Workflows v2. Default stack, override conditions, auth, data patterns, reliability.

The English summary is being prepared. Showing the original description.

heymegabyte/agent-skills24Updated Oct 11, 2026

Extract real brands (Wayback for rebuilds). Copy system, headline/CTA rules, trust surfaces, legal pages, SEO+structured data, anti-AI-slop, microcopy, DESIGN.md, W3C DTCG tokens, pSEO 5 types, GEO/AI search.

The English summary is being prepared. Showing the original description.

heymegabyte/agent-skills24Updated Oct 11, 2026

Implements features in vertical slices, always starting with homepage. Enforces anti-placeholder rules — no lorem ipsum, no TODO stubs, no gray boxes. Real content, real images, real interactions. TypeScript strict mode, Zod validation, and structured file organization.

The English summary is being prepared. Showing the original description.

heymegabyte/agent-skills24Updated Oct 11, 2026

The consolidated, world-class Cloudflare + integrations reference — CF platform/data/AI-edge patterns, media pipeline, observability/growth, payments, and the site-generation pipeline. The non-inferable choices that build the greatest web apps.

The English summary is being prepared. Showing the original description.

heymegabyte/agent-skills24Updated Oct 11, 2026

One-line-prompt → cinematic, gorgeous, functional, well-tested, deployed website. Pre-hydrated SPA + full PWA kit + JSON-LD rich snippets + third-party integrations. React 19+Vite default (Angular optional). 100 concrete improvements grouped into 10 categories that EVERY single-prompt site build must satisfy before being marked done. Trigger whenever the user says 'make a website for X', 'build a site for X', 'rebuild X.com', or any equivalent one-liner.

The English summary is being prepared. Showing the original description.

heymegabyte/agent-skills24Updated Oct 11, 2026

See all skills by heymegabyte

Report a problem with this skill