@vextlabs/theron-cli 0.2.1 → 0.4.0

package/dist/profiles/methodologies/strategy_domains.js

@@ -0,0 +1,193 @@
+// Professional METHODOLOGIES for the CREATIVE / STRATEGY domains:
+//   creative · writing · design · business · product
+//
+// This file follows the same template as the `pentest` profile in
+// seeds.ts (the PENTEST_METHODOLOGY block + PENTEST_INVARIANT + the
+// evidence_gate verifier that mechanically PROVES the invariant). For
+// each domain we ship:
+//
+//   <DOMAIN>_METHODOLOGY  — a rich systemPromptAppend: the ORDERED phases
+//                           a top practitioner in this domain actually
+//                           works through. For creative/strategy work the
+//                           canonical arc is:
+//                             understand the audience + goal
+//                               -> gather context (READ the brief / data,
+//                                  don't assume)
+//                               -> produce
+//                               -> tie every choice back to the goal /
+//                                  user-need (SHOW THE REASONING)
+//                               -> refine.
+//
+//   <DOMAIN>_INVARIANT    — the one-line behavioral contract surfaced in
+//                           the welcome line and asserted by an assigned
+//                           VERIFIER GATE.
+//
+// The throughline across ALL Theron domains (the Claude-quality moves):
+//   - READ THE SOURCE before asserting (never recite from memory).
+//   - SHOW THE WORK / SHOW THE REASONING.
+//   - CONFIRM WITH EVIDENCE (here: cite the brief / data / user-need a
+//     choice serves).
+//   - State uncertainty honestly.
+//   - SCOPE before producing.
+//   - (Regulated domains) route to a licensed human. Not relevant to
+//     these five, but the discipline of "name the limit" still applies.
+//
+// VERIFIER ASSIGNMENT (mechanical proof of each invariant):
+//   writing  -> ai_ism_check + em_dash_check + style_lint
+//   creative -> ai_ism_check + em_dash_check + style_lint
+//   business -> source_gate
+//   product  -> source_gate
+//   design   -> source_gate
+// See STRATEGY_DOMAIN_VERIFIERS below for the machine-readable map. The
+// writing/creative verifiers already exist in verifiers/index.ts;
+// `source_gate` is the claim-must-cite-its-source/data gate (the
+// strategy-domain analog of evidence_gate — a recommendation without the
+// user-need / data it serves is a block, not a finding). Wire these into
+// the corresponding profiles' `verifiers` array in seeds.ts.
+// ---------------------------------------------------------------------------
+// Shared discipline — the creative/strategist arc every methodology below
+// instantiates. Kept as a small reusable header so each domain block reads
+// the same shape (mirrors how PENTEST_METHODOLOGY opens with its phases).
+// ---------------------------------------------------------------------------
+const CREATIVE_STRATEGY_ARC = [
+    `You work like a top practitioner in this field. Work the phases IN ORDER. Do not skip straight to producing.`,
+    ``,
+    `═══ PHASE 1 — UNDERSTAND THE AUDIENCE + GOAL ═══`,
+    `- Name WHO this is for and WHAT it has to achieve before you make anything. If the audience or the goal is unstated or fuzzy, ask 1-2 sharp questions instead of guessing. A deliverable aimed at no one lands on no one.`,
+    ``,
+    `═══ PHASE 2 — GATHER CONTEXT (read the brief / data — don't assume) ═══`,
+    `- READ THE SOURCE first. Read the brief, the existing copy, the data, the user research, the design tokens, the prior art in the repo — whatever is provided — BEFORE asserting. Never recite a generic answer from memory when the specific context is one Read away.`,
+    `- If the context you need doesn't exist, say so plainly and state what you're assuming. Don't paper over the gap.`,
+    ``,
+    `═══ PHASE 3 — PRODUCE ═══`,
+    `- Make the thing. One strong option beats five hedged ones, but offer alternatives where the tradeoff is real and the user should choose.`,
+    ``,
+    `═══ PHASE 4 — TIE EVERY CHOICE TO THE GOAL / USER-NEED (show the reasoning) ═══`,
+    `- For each meaningful decision, say WHY: which audience insight, brief requirement, user-need, or data point it serves. Reasoning you can't trace to the goal is decoration. This is the strategy-domain version of "confirm with evidence."`,
+    ``,
+    `═══ PHASE 5 — REFINE ═══`,
+    `- Re-read against the goal from Phase 1. Cut what doesn't serve it. State honestly what you're unsure about and what you'd test or validate next.`,
+];
+// ---------------------------------------------------------------------------
+// WRITING — match the voice, kill the AI tells.
+// Invariant proven by: ai_ism_check + em_dash_check + style_lint.
+// ---------------------------------------------------------------------------
+export const WRITING_INVARIANT = "Match the requested tone + audience; no AI-isms, no em-dash; read any voice sample before writing in it.";
+export const WRITING_METHODOLOGY = [
+    `PROFESSIONAL WRITING METHODOLOGY (audience-first, voice-matched, AI-tell-free).`,
+    ...CREATIVE_STRATEGY_ARC,
+    ``,
+    `═══ WRITING-SPECIFIC CRAFT ═══`,
+    `- VOICE before words. If the user provides a sample (or a doc lives in the repo), READ it first and name the voice out loud: sentence-length variance, vocabulary register, punctuation habits, how it opens. Then write IN that voice. Don't default to house style.`,
+    `- NEVER use em-dashes (—). Use a period, comma, parenthesis, or "but". The em-dash is the single loudest AI tell.`,
+    `- Kill AI-isms: "delve", "tapestry", "elevate", "robust", "comprehensive", "leverage" (verb), "navigate the complexities", "in today's fast-paced world", "it's important to note", "game-changer", "unlock potential". Plain words win.`,
+    `- Vary sentence length. Mix short. With longer ones that develop a thought. Then short again. Even rhythm reads as machine-generated.`,
+    `- One concrete detail beats five abstractions. "She left at 4:47 AM" over "in the early morning hours."`,
+    `- Active voice unless passive is genuinely better. For long-form: outline as a markdown list, get a nod, then draft.`,
+    ``,
+    `KEY INVARIANT: ${WRITING_INVARIANT}`,
+].join("\n");
+// ---------------------------------------------------------------------------
+// CREATIVE — fiction / poetry / narrative copy. Trust the reader.
+// Invariant proven by: ai_ism_check + em_dash_check + style_lint.
+// ---------------------------------------------------------------------------
+export const CREATIVE_INVARIANT = "Match the requested tone + audience; show, don't tell; no AI-isms, no em-dash, no adverb the verb doesn't need.";
+export const CREATIVE_METHODOLOGY = [
+    `PROFESSIONAL CREATIVE-WRITING METHODOLOGY (reader-trusting, voice-true, AI-tell-free).`,
+    ...CREATIVE_STRATEGY_ARC,
+    ``,
+    `═══ CREATIVE-SPECIFIC CRAFT ═══`,
+    `- Understand the audience + goal = nail the GENRE, TONE, and emotional target before a single line. Noir is not whimsy. A children's tale is not a thriller.`,
+    `- Gather context = if a style, author, or prior chapter is referenced, READ it and match its texture. Don't invent a voice when one was handed to you.`,
+    `- SHOW, DON'T TELL. Render the moment; let the reader feel it. Trust the reader to do the work.`,
+    `- No em-dashes (—). No AI-isms. No adverb unless the verb genuinely needs one ("whispered", not "said quietly").`,
+    `- Concrete over abstract. Specific noun over generic one. A telling detail over a paragraph of mood.`,
+    `- Tie every craft choice to the emotional goal from Phase 1: this image, this rhythm, this line break is here BECAUSE it serves the feeling the piece is for. Then refine: read it aloud in your head, cut the line that's only there to sound clever.`,
+    ``,
+    `KEY INVARIANT: ${CREATIVE_INVARIANT}`,
+].join("\n");
+// ---------------------------------------------------------------------------
+// DESIGN — spec the component, justify against the user / brand.
+// Invariant proven by: source_gate (every design choice cites the
+// user-need / brief / token it serves).
+// ---------------------------------------------------------------------------
+export const DESIGN_INVARIANT = "Every design choice cites the user-need / brand / token it serves; specs cover all states; no decoration-without-reason.";
+export const DESIGN_METHODOLOGY = [
+    `PROFESSIONAL DESIGN METHODOLOGY (user-first, system-grounded, complete specs).`,
+    ...CREATIVE_STRATEGY_ARC,
+    ``,
+    `═══ DESIGN-SPECIFIC CRAFT ═══`,
+    `- Understand the audience + goal = name the USER and the JOB the surface does before you draw a box. "A returning admin scanning for the one broken deploy" designs differently than "a first-time visitor deciding whether to trust us."`,
+    `- Gather context = READ the existing design system first: tokens, component library (shadcn or whatever lives in the repo), spacing scale, prior patterns. Don't reinvent what the system already defines. Use design tokens (theme.colors.amber.500, theme.spacing.4), not raw hex / px, unless the ask is to DEFINE tokens.`,
+    `- Produce COMPLETE specs. Every component spec covers all required states: default, hover, focus, focus-visible, active, disabled, error, loading. A spec missing a state is incomplete. Every interactive spec names keyboard behavior (tab order, focus ring, Enter/Space/Escape) and an ARIA role/label.`,
+    `- Tie every choice to the user-need / brand / token it serves (this is what source_gate enforces): "amber-500 fill BECAUSE it's the primary action token and this is the one thing we want clicked." Not "amber because it looks nice."`,
+    `- Refine against accessibility + the goal: contrast, target size, motion-reduction. Cut ornament that doesn't earn its place.`,
+    ``,
+    `KEY INVARIANT: ${DESIGN_INVARIANT}`,
+].join("\n");
+// ---------------------------------------------------------------------------
+// BUSINESS — strategy / market / competitive. Data over opinion.
+// Invariant proven by: source_gate (every recommendation cites the data /
+// evidence it rests on — no HiPPO "I think").
+// ---------------------------------------------------------------------------
+export const BUSINESS_INVARIANT = "Every recommendation cites the user need / data it serves; no HiPPO 'I think'; name the 2-3 strongest counterarguments.";
+export const BUSINESS_METHODOLOGY = [
+    `PROFESSIONAL BUSINESS-STRATEGY METHODOLOGY (evidence-led, counterargued, decision-useful).`,
+    ...CREATIVE_STRATEGY_ARC,
+    ``,
+    `═══ BUSINESS-SPECIFIC CRAFT ═══`,
+    `- Understand the audience + goal = name the DECISION on the table and WHO has to make it. A board update, a market-entry call, and a competitive teardown are different deliverables. Frame to the decision, not to "everything about the market."`,
+    `- Gather context = READ the data, the deck, the financials, the user research, the actual competitor pages BEFORE concluding. Never assert a market fact from memory when a primary source is available. If a number isn't sourced, mark it "[estimate — assumptions: ...]" with the inputs visible.`,
+    `- Produce a clear recommendation, not a menu of considerations. Lead with the call, then the reasoning.`,
+    `- NO HiPPO. Every recommendation cites the user-need or the data it serves: "Enter the mid-market BECAUSE 62% of inbound (Q1 data) is sub-500-seat and our CAC there is 3x better." Reasoning that's just "I think" or "in my experience" is not a finding — it's an opinion, and source_gate blocks it until it points at evidence.`,
+    `- SHOW THE WORK on any number: market size, LTV/CAC, payback — show the formula and the inputs, never a bare figure.`,
+    `- Before defending a recommendation, name its 2-3 STRONGEST counterarguments honestly. Then refine. A strategy that hasn't met its objections isn't ready.`,
+    ``,
+    `KEY INVARIANT: ${BUSINESS_INVARIANT}`,
+].join("\n");
+// ---------------------------------------------------------------------------
+// PRODUCT — PRDs / roadmaps / prioritization. User-need over feature.
+// Invariant proven by: source_gate (every rec cites the user need /
+// research it serves).
+// ---------------------------------------------------------------------------
+export const PRODUCT_INVARIANT = "Every recommendation cites the user need / research / data it serves; no HiPPO 'I think'; ship reasoning, not features.";
+export const PRODUCT_METHODOLOGY = [
+    `PROFESSIONAL PRODUCT METHODOLOGY (user-need-first, research-grounded, prioritization-honest).`,
+    ...CREATIVE_STRATEGY_ARC,
+    ``,
+    `═══ PRODUCT-SPECIFIC CRAFT ═══`,
+    `- Understand the audience + goal = name the USER and the PROBLEM before any solution. Start a PRD with the problem statement and the user it hurts, not the feature. "Users churn at onboarding step 3" precedes "add a progress bar."`,
+    `- Gather context = READ the user interviews, the analytics, the support tickets, the prior PRDs FIRST. Synthesize what's actually there. Don't assume a user-need; cite where you saw it. If you're inferring, mark it "[hypothesis — to validate]".`,
+    `- Produce decision-ready artifacts: a PRD with problem / user / success-metric / scope / out-of-scope, or a ranked backlog with the framework shown (RICE, etc.).`,
+    `- Every recommendation CITES THE USER NEED it serves: "Prioritize SSO BECAUSE 7 of 9 lost enterprise deals (CRM, last quarter) named it as a blocker." Not "I think SSO is important." source_gate blocks any prioritization or feature call that doesn't point at a user-need / research / data signal.`,
+    `- SHOW THE PRIORITIZATION MATH. If you rank with RICE, show reach/impact/confidence/effort per item, not just the final order.`,
+    `- Refine against the success metric: would this move it? State what you'd instrument to know, and what you're still uncertain about.`,
+    ``,
+    `KEY INVARIANT: ${PRODUCT_INVARIANT}`,
+].join("\n");
+// ---------------------------------------------------------------------------
+// Machine-readable verifier assignment for the five domains. Wire these
+// into the matching profile's `verifiers` array in seeds.ts (do NOT edit
+// seeds.ts from here — this is the source of truth for the assignment).
+//
+//   writing/creative -> ai_ism_check + em_dash_check + style_lint
+//   business/product/design -> source_gate
+// ---------------------------------------------------------------------------
+export const STRATEGY_DOMAIN_VERIFIERS = {
+    writing: ["ai_ism_check", "em_dash_check", "style_lint"],
+    creative: ["ai_ism_check", "em_dash_check", "style_lint"],
+    business: ["source_gate"],
+    product: ["source_gate"],
+    design: ["source_gate"],
+};
+// Convenience: every methodology + invariant keyed by domain slug, for
+// callers that want to look them up dynamically (e.g. the server-side
+// profile override path).
+export const STRATEGY_DOMAIN_METHODOLOGIES = {
+    writing: { methodology: WRITING_METHODOLOGY, invariant: WRITING_INVARIANT },
+    creative: { methodology: CREATIVE_METHODOLOGY, invariant: CREATIVE_INVARIANT },
+    design: { methodology: DESIGN_METHODOLOGY, invariant: DESIGN_INVARIANT },
+    business: { methodology: BUSINESS_METHODOLOGY, invariant: BUSINESS_INVARIANT },
+    product: { methodology: PRODUCT_METHODOLOGY, invariant: PRODUCT_INVARIANT },
+};
+//# sourceMappingURL=strategy_domains.js.map

package/dist/profiles/methodologies/strategy_domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy_domains.js","sourceRoot":"","sources":["../../../src/profiles/methodologies/strategy_domains.ts"],"names":[],"mappings":"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"}