npm - claude-code-arcane - Versions diffs - 1.0.0 - Mend

claude-code-arcane 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1778) hide show

package/skills/email-template-builder/references/react-email-templates.md ADDED Viewed

@@ -0,0 +1,323 @@
+# React Email Templates
+## Base Email Layout
+```tsx
+// emails/components/layout/email-layout.tsx
+import {
+  Body, Container, Head, Html, Img, Preview, Section, Text, Hr, Font
+} from "@react-email/components"
+interface EmailLayoutProps {
+  preview: string
+  children: React.ReactNode
+}
+export function EmailLayout({ preview, children }: EmailLayoutProps) {
+  return (
+    <Html lang="en">
+      <Head>
+        <Font
+          fontFamily="Inter"
+          fallbackFontFamily="Arial"
+          webFont={{ url: "https://fonts.gstatic.com/s/inter/v13/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hiJ-Ek-_EeA.woff2", format: "woff2" }}
+          fontWeight={400}
+          fontStyle="normal"
+        />
+        {/* Dark mode styles */}
+        <style>{`
+          @media (prefers-color-scheme: dark) {
+            .email-body { background-color: #0f0f0f !important; }
+            .email-container { background-color: #1a1a1a !important; }
+            .email-text { color: #e5e5e5 !important; }
+            .email-heading { color: #ffffff !important; }
+            .email-divider { border-color: #333333 !important; }
+          }
+        `}</style>
+      </Head>
+      <Preview>{preview}</Preview>
+      <Body className="email-body" style={styles.body}>
+        <Container className="email-container" style={styles.container}>
+          {/* Header */}
+          <Section style={styles.header}>
+            <Img src="https://yourapp.com/logo.png" width={120} height={40} alt="MyApp" />
+          </Section>
+          {/* Content */}
+          <Section style={styles.content}>
+            {children}
+          </Section>
+          {/* Footer */}
+          <Hr style={styles.divider} />
+          <Section style={styles.footer}>
+            <Text style={styles.footerText}>
+              MyApp Inc. · 123 Main St · San Francisco, CA 94105
+            </Text>
+            <Text style={styles.footerText}>
+              <a href="{{unsubscribe_url}}" style={styles.link}>Unsubscribe</a>
+              {" · "}
+              <a href="https://yourapp.com/privacy" style={styles.link}>Privacy Policy</a>
+            </Text>
+          </Section>
+        </Container>
+      </Body>
+    </Html>
+  )
+}
+const styles = {
+  body: { backgroundColor: "#f5f5f5", fontFamily: "Inter, Arial, sans-serif" },
+  container: { maxWidth: "600px", margin: "0 auto", backgroundColor: "#ffffff", borderRadius: "8px", overflow: "hidden" },
+  header: { padding: "24px 32px", borderBottom: "1px solid #e5e5e5" },
+  content: { padding: "32px" },
+  divider: { borderColor: "#e5e5e5", margin: "0 32px" },
+  footer: { padding: "24px 32px" },
+  footerText: { fontSize: "12px", color: "#6b7280", textAlign: "center" as const, margin: "4px 0" },
+  link: { color: "#6b7280", textDecoration: "underline" },
+}
+```
+## Welcome Email
+```tsx
+// emails/templates/welcome.tsx
+import { Button, Heading, Text } from "@react-email/components"
+import { EmailLayout } from "../components/layout/email-layout"
+interface WelcomeEmailProps {
+  name: string
+  confirmUrl: string
+  trialDays?: number
+}
+export function WelcomeEmail({ name, confirmUrl, trialDays = 14 }: WelcomeEmailProps) {
+  return (
+    <EmailLayout preview={`Welcome to MyApp, ${name}! Confirm your email to get started.`}>
+      <Heading style={styles.h1}>Welcome to MyApp, {name}!</Heading>
+      <Text style={styles.text}>
+        We're excited to have you on board. You've got {trialDays} days to explore everything MyApp has to offer — no credit card required.
+      </Text>
+      <Text style={styles.text}>
+        First, confirm your email address to activate your account:
+      </Text>
+      <Button href={confirmUrl} style={styles.button}>
+        Confirm Email Address
+      </Button>
+      <Text style={styles.hint}>
+        Button not working? Copy and paste this link into your browser:
+        <br />
+        <a href={confirmUrl} style={styles.link}>{confirmUrl}</a>
+      </Text>
+      <Text style={styles.text}>
+        Once confirmed, you can:
+      </Text>
+      <ul style={styles.list}>
+        <li>Connect your first project in 2 minutes</li>
+        <li>Invite your team (free for up to 3 members)</li>
+        <li>Set up Slack notifications</li>
+      </ul>
+    </EmailLayout>
+  )
+}
+export default WelcomeEmail
+const styles = {
+  h1: { fontSize: "28px", fontWeight: "700", color: "#111827", margin: "0 0 16px" },
+  text: { fontSize: "16px", lineHeight: "1.6", color: "#374151", margin: "0 0 16px" },
+  button: { backgroundColor: "#4f46e5", color: "#ffffff", borderRadius: "6px", fontSize: "16px", fontWeight: "600", padding: "12px 24px", textDecoration: "none", display: "inline-block", margin: "8px 0 24px" },
+  hint: { fontSize: "13px", color: "#6b7280" },
+  link: { color: "#4f46e5" },
+  list: { fontSize: "16px", lineHeight: "1.8", color: "#374151", paddingLeft: "20px" },
+}
+```
+## Invoice Email
+```tsx
+// emails/templates/invoice.tsx
+import { Row, Column, Section, Heading, Text, Hr, Button } from "@react-email/components"
+import { EmailLayout } from "../components/layout/email-layout"
+interface InvoiceItem { description: string; amount: number }
+interface InvoiceEmailProps {
+  name: string
+  invoiceNumber: string
+  invoiceDate: string
+  dueDate: string
+  items: InvoiceItem[]
+  total: number
+  currency: string
+  downloadUrl: string
+}
+export function InvoiceEmail({ name, invoiceNumber, invoiceDate, dueDate, items, total, currency = "USD", downloadUrl }: InvoiceEmailProps) {
+  const formatter = new Intl.NumberFormat("en-US", { style: "currency", currency })
+  return (
+    <EmailLayout preview={`Invoice ${invoiceNumber} - ${formatter.format(total / 100)}`}>
+      <Heading style={styles.h1}>Invoice #{invoiceNumber}</Heading>
+      <Text style={styles.text}>Hi {name},</Text>
+      <Text style={styles.text}>Here's your invoice from MyApp. Thank you for your continued support.</Text>
+      {/* Invoice Meta */}
+      <Section style={styles.metaBox}>
+        <Row>
+          <Column><Text style={styles.metaLabel}>Invoice Date</Text><Text style={styles.metaValue}>{invoiceDate}</Text></Column>
+          <Column><Text style={styles.metaLabel}>Due Date</Text><Text style={styles.metaValue}>{dueDate}</Text></Column>
+          <Column><Text style={styles.metaLabel}>Amount Due</Text><Text style={styles.metaValueLarge}>{formatter.format(total / 100)}</Text></Column>
+        </Row>
+      </Section>
+      {/* Line Items */}
+      <Section style={styles.table}>
+        <Row style={styles.tableHeader}>
+          <Column><Text style={styles.tableHeaderText}>Description</Text></Column>
+          <Column><Text style={{ ...styles.tableHeaderText, textAlign: "right" }}>Amount</Text></Column>
+        </Row>
+        {items.map((item, i) => (
+          <Row key={i} style={i % 2 === 0 ? styles.tableRowEven : styles.tableRowOdd}>
+            <Column><Text style={styles.tableCell}>{item.description}</Text></Column>
+            <Column><Text style={{ ...styles.tableCell, textAlign: "right" }}>{formatter.format(item.amount / 100)}</Text></Column>
+          </Row>
+        ))}
+        <Hr style={styles.divider} />
+        <Row>
+          <Column><Text style={styles.totalLabel}>Total</Text></Column>
+          <Column><Text style={styles.totalValue}>{formatter.format(total / 100)}</Text></Column>
+        </Row>
+      </Section>
+      <Button href={downloadUrl} style={styles.button}>Download PDF Invoice</Button>
+    </EmailLayout>
+  )
+}
+export default InvoiceEmail
+const styles = {
+  h1: { fontSize: "24px", fontWeight: "700", color: "#111827", margin: "0 0 16px" },
+  text: { fontSize: "15px", lineHeight: "1.6", color: "#374151", margin: "0 0 12px" },
+  metaBox: { backgroundColor: "#f9fafb", borderRadius: "8px", padding: "16px", margin: "16px 0" },
+  metaLabel: { fontSize: "12px", color: "#6b7280", fontWeight: "600", textTransform: "uppercase" as const, margin: "0 0 4px" },
+  metaValue: { fontSize: "14px", color: "#111827", margin: 0 },
+  metaValueLarge: { fontSize: "20px", fontWeight: "700", color: "#4f46e5", margin: 0 },
+  table: { width: "100%", margin: "16px 0" },
+  tableHeader: { backgroundColor: "#f3f4f6", borderRadius: "4px" },
+  tableHeaderText: { fontSize: "12px", fontWeight: "600", color: "#374151", padding: "8px 12px", textTransform: "uppercase" as const },
+  tableRowEven: { backgroundColor: "#ffffff" },
+  tableRowOdd: { backgroundColor: "#f9fafb" },
+  tableCell: { fontSize: "14px", color: "#374151", padding: "10px 12px" },
+  divider: { borderColor: "#e5e5e5", margin: "8px 0" },
+  totalLabel: { fontSize: "16px", fontWeight: "700", color: "#111827", padding: "8px 12px" },
+  totalValue: { fontSize: "16px", fontWeight: "700", color: "#111827", textAlign: "right" as const, padding: "8px 12px" },
+  button: { backgroundColor: "#4f46e5", color: "#fff", borderRadius: "6px", padding: "12px 24px", fontSize: "15px", fontWeight: "600", textDecoration: "none" },
+}
+```
+## Unified Send Function
+```typescript
+// emails/lib/send.ts
+import { Resend } from "resend"
+import { render } from "@react-email/render"
+import { WelcomeEmail } from "../templates/welcome"
+import { InvoiceEmail } from "../templates/invoice"
+import { addTrackingParams } from "./tracking"
+const resend = new Resend(process.env.RESEND_API_KEY)
+type EmailPayload =
+  | { type: "welcome"; props: Parameters<typeof WelcomeEmail>[0] }
+  | { type: "invoice"; props: Parameters<typeof InvoiceEmail>[0] }
+export async function sendEmail(to: string, payload: EmailPayload) {
+  const templates = {
+    welcome: { component: WelcomeEmail, subject: "Welcome to MyApp — confirm your email" },
+    invoice: { component: InvoiceEmail, subject: `Invoice from MyApp` },
+  }
+  const template = templates[payload.type]
+  const html = render(template.component(payload.props as any))
+  const trackedHtml = addTrackingParams(html, { campaign: payload.type })
+  const result = await resend.emails.send({
+    from: "MyApp <hello@yourapp.com>",
+    to,
+    subject: template.subject,
+    html: trackedHtml,
+    tags: [{ name: "email-type", value: payload.type }],
+  })
+  return result
+}
+```
+## i18n Support
+```typescript
+// emails/i18n/en.ts
+export const en = {
+  welcome: {
+    preview: (name: string) => `Welcome to MyApp, ${name}!`,
+    heading: (name: string) => `Welcome to MyApp, ${name}!`,
+    body: (days: number) => `You've got ${days} days to explore everything.`,
+    cta: "Confirm Email Address",
+  },
+}
+// emails/i18n/de.ts
+export const de = {
+  welcome: {
+    preview: (name: string) => `Willkommen bei MyApp, ${name}!`,
+    heading: (name: string) => `Willkommen bei MyApp, ${name}!`,
+    body: (days: number) => `Du hast ${days} Tage Zeit, alles zu erkunden.`,
+    cta: "E-Mail-Adresse bestätigen",
+  },
+}
+// Usage in template
+import { en, de } from "../i18n"
+const t = locale === "de" ? de : en
+```
+## Analytics Tracking
+```typescript
+// emails/lib/tracking.ts
+interface TrackingParams {
+  campaign: string
+  medium?: string
+  source?: string
+}
+export function addTrackingParams(html: string, params: TrackingParams): string {
+  const utmString = new URLSearchParams({
+    utm_source: params.source ?? "email",
+    utm_medium: params.medium ?? "transactional",
+    utm_campaign: params.campaign,
+  }).toString()
+  // Add UTM params to all links in the email
+  return html.replace(/href="(https?:\/\/[^"]+)"/g, (match, url) => {
+    const separator = url.includes("?") ? "&" : "?"
+    return `href="${url}${separator}${utmString}"`
+  })
+}
+```
+## Preview Server Setup
+```typescript
+// package.json scripts
+{
+  "scripts": {
+    "email:dev": "email dev --dir emails/templates --port 3001",
+    "email:build": "email export --dir emails/templates --outDir emails/out"
+  }
+}
+// Run: npm run email:dev
+// Opens: http://localhost:3001
+// Shows all templates with live preview and hot reload
+```

package/skills/env-sync/SKILL.md ADDED Viewed

@@ -0,0 +1,102 @@
+---
+name: env-sync
+description: "Compara .env.example vs .env real, detecta variables faltantes, extra o con valores default. Usar cuando se mencione: env, variables de entorno, .env, environment variables, config check, setup."
+category: "operations"
+argument-hint: "[path to .env root, default .]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash
+---
+# Environment Sync Checker
+Verifica que las variables de entorno estén sincronizadas entre `.env.example` y `.env`.
+## Process
+### 1. Detectar archivos
+Buscar en el directorio actual:
+- `.env.example` / `.env.sample` / `.env.template`
+- `.env` / `.env.local` / `.env.development` / `.env.production`
+- `docker-compose.yml` (extraer variables de `environment:`)
+- `config/` o archivos de config que referencien env vars
+### 2. Parsear variables
+De cada archivo, extraer:
+- Nombre de la variable
+- Valor (o vacío)
+- Si tiene comentario explicativo
+### 3. Comparar
+| Check | Detalle |
+|-------|---------|
+| **Faltantes en .env** | Variables en .example que no están en .env |
+| **Extra en .env** | Variables en .env que no están en .example (posible leak de config vieja) |
+| **Valores default** | Variables en .env que todavía tienen el valor de ejemplo ("your-key-here", "changeme", etc.) |
+| **Vacías requeridas** | Variables sin valor que probablemente son requeridas |
+| **Secrets en .example** | Valores que parecen tokens/keys reales en el .example (red flag) |
+### 4. Verificar .gitignore
+```bash
+# Asegurar que .env NO está trackeado
+git ls-files --error-unmatch .env 2>/dev/null
+```
+Si `.env` está trackeado → **ALERTA CRÍTICA**.
+### 5. Cross-check con código
+Buscar en el código variables de entorno que NO están en .env.example:
+```bash
+# Go
+grep -rn 'os.Getenv\|viper.Get' --include="*.go" | grep -oP '"[A-Z_]+"'
+# Node.js
+grep -rn 'process.env\.' --include="*.ts" --include="*.js" | grep -oP '\.[A-Z_]+'
+# Python
+grep -rn 'os.environ\|os.getenv' --include="*.py" | grep -oP '"[A-Z_]+"'
+```
+### 6. Reporte
+```markdown
+# Env Sync Report — [fecha]
+## Estado: [OK / WARN / CRITICAL]
+## Variables faltantes en .env (necesitás agregar)
+| Variable | Descripción | Valor sugerido |
+|----------|-------------|----------------|
+## Variables con valor default (revisar)
+| Variable | Valor actual | Acción |
+|----------|-------------|--------|
+## Variables extra en .env (posiblemente obsoletas)
+| Variable | Valor |
+|----------|-------|
+## Variables en código sin .env.example
+| Variable | Archivo | Línea |
+|----------|---------|-------|
+## Seguridad
+- .env en .gitignore: [SI/NO]
+- .env trackeado en git: [SI/NO]
+- Secrets en .env.example: [lista]
+```
+### 7. Fix automático (si el usuario acepta)
+- Agregar variables faltantes a `.env` con valores de ejemplo
+- Agregar variables del código faltantes a `.env.example`
+- Agregar `.env` a `.gitignore` si falta
+## Rules
+- NUNCA mostrar valores de secrets reales en el output
+- Si hay secrets en .env.example → advertir inmediatamente
+- En español

package/skills/error-tracking/SKILL.md ADDED Viewed

@@ -0,0 +1,25 @@
+---
+name: error-tracking
+description: "Error tracking y crash reporting para apps Educabot (Go/TS/React/RN) con Bugsnag: source maps, symbolication, release tracking, stability score, PII scrubbing, triage."
+category: "observability"
+argument-hint: "[setup|triage|release <version>]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit, Task
+---
+# error-tracking — Bugsnag Error Tracking
+**Default Educabot: Bugsnag.** Un project por app (separar web/mobile/api). Target: >99.9% crash-free sessions.
+## Platform Decision
+| Tool | Fuerte en | Cuando |
+|------|-----------|--------|
+| **Bugsnag** | Mobile stability, triage, symbolication | **Default** |
+| Sentry | APM + errors + replay en una tool | Si se necesita APM integrado |
+| Datadog Error Tracking | Integrado con APM/logs | Si ya pagan DD suite |
+> → Read references/setup-per-stack.md for Go, Node/TS, React, React Native setup and release tracking
+> → Read references/operational-details.md for user context, PII scrubbing, sampling, grouping, alertas, and triage workflow
+> → Read references/anti-patterns-and-checklist.md for anti-patterns and implementation checklist

package/skills/error-tracking/references/anti-patterns-and-checklist.md ADDED Viewed

@@ -0,0 +1,23 @@
+# Error Tracking Anti-Patterns & Checklist
+## Anti-patterns
+- apiKey hardcoded, sin source maps/dSYM/Proguard, .map publicos
+- Samplear errors <100%, enviar PII/datos menores, un project para todas las apps
+- Release sin appVersion+commit, sin releaseStage, alertar info/warning
+- Ignorar ruido (ahoga senal), no actuar en alta frecuencia, Bugsnag como logger
+## Checklist
+- [ ] Projects separados por app (web/mobile/api)
+- [ ] API keys por env via env vars
+- [ ] releaseStage + appVersion configurados
+- [ ] Source maps subidos en CI (browser + Hermes), no publicos
+- [ ] dSYM iOS + Proguard Android subidos en CI
+- [ ] redactedKeys verificado (passwords, tokens, PII, DNI/CUIT)
+- [ ] ErrorBoundary en React root
+- [ ] unhandledRejection handler en Node
+- [ ] Breadcrumbs en flows criticos
+- [ ] User id + tenantId en metadata (sin email/PII menores)
+- [ ] onError filter ruido conocido
+- [ ] Alertas: new/regression -> Slack, spike -> PagerDuty
+- [ ] Jira/ClickUp integration activa
+- [ ] Triage daily + weekly documentado

package/skills/error-tracking/references/operational-details.md ADDED Viewed

@@ -0,0 +1,38 @@
+# Error Tracking Operational Details
+## User Context & Breadcrumbs
+- `setUser(id)` — **no email de menores**. `addMetadata('tenant', {id, plan})`
+- Breadcrumbs auto (navigation, fetch, console) + manuales en flows criticos
+- Ultimos 50 eventos antes del error = oro para debugging
+## PII Scrubbing
+```
+redactedKeys: ['password', 'token', 'authorization', 'cookie', /dni/i, /cuit/i, /cpf/i, /credit.?card/i]
+```
+- Menores: solo `user.id` interno, no email/nombre real
+- Respetar consent: si usuario rechazo crash reporting -> `pauseSession()`
+## Sampling & Ruido
+- Errors: **100% siempre** (no samplear)
+- Filtrar ruido: ResizeObserver, chrome-extension, Non-Error promise rejection
+- Dedupe burst: mismo error <5s -> skip
+## Grouping
+Default por stack+message. Override con `groupingHash` cuando agrupa mal (network errors con URL variable, validation con mensaje dinamico).
+## Alertas & Routing
+| Evento | Destino |
+|--------|---------|
+| New issue production | Slack #alerts-prod |
+| Regression (resolved reaparecio) | Slack + reopen ticket |
+| Spike >10x en 5min | PagerDuty on-call |
+| Stability <99.5% mobile | Alert weekly |
+Anti-fatiga: no alertar info a on-call, staging solo Slack.
+## Triage Workflow
+**Diario:** inbox new 24h -> clasificar (bug/noise/regression) -> asignar -> Jira si >1h
+**Weekly:** top 10 frecuencia, top 10 users afectados, stability por release

package/skills/error-tracking/references/setup-per-stack.md ADDED Viewed

@@ -0,0 +1,24 @@
+# Error Tracking Setup per Stack
+## Go Backend
+- `bugsnag-go/v2`: Configure con APIKey, ReleaseStage, AppVersion, ProjectPackages
+- Gin middleware: `defer bugsnag.AutoNotify(ctx, req)`. Panics auto-recovered
+- Manual: `bugsnag.Notify(err, ctx, bugsnag.MetaData{...})`
+## Node/TS (Fastify/Express)
+- `@bugsnag/js` + plugin express. `redactedKeys` para PII
+- `onError` filter para no reportar ValidationError
+- `process.on('unhandledRejection', Bugsnag.notify)`
+## React + Vite
+- `@bugsnag/plugin-react` ErrorBoundary wrapping `<App />`
+- **Source maps critico:** upload con `@bugsnag/source-maps upload-browser` en CI. No servir `.map` publicos
+## React Native / Expo
+- `@bugsnag/react-native` con `codeBundleId` para OTA updates
+- **Symbolication:** dSYM iOS (`bugsnag-dsym-upload`), Proguard Android, Hermes source maps
+- Sin symbolication -> stacks ofuscados inutilizables
+## Release Tracking
+- CI post-deploy: upload source maps + Build API report (`appVersion`, `revision`, `releaseStage`)
+- Stability score por release -> regressions visibles

package/skills/estimate/SKILL.md ADDED Viewed

@@ -0,0 +1,51 @@
+---
+name: estimate
+description: "Estimates task effort by analyzing complexity, dependencies, historical velocity, and risk factors. Produces a structured estimate with confidence levels."
+category: "agile"
+argument-hint: "[task-description]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep
+---
+## Phase 1: Understand the Task
+Read the task description from the argument. If the description is too vague to estimate meaningfully, ask for clarification before proceeding.
+Read CLAUDE.md for project context: tech stack, coding standards, architectural patterns, and any estimation guidelines.
+Read relevant design documents from `design/gdd/` if the task relates to a documented feature or system.
+---
+## Phase 2: Scan Affected Code
+Identify files and modules that would need to change:
+- Assess complexity (size, dependency count, cyclomatic complexity)
+- Identify integration points with other systems
+- Check for existing test coverage in the affected areas
+- Read past sprint data from `production/sprints/` for similar completed tasks and historical velocity
+---
+## Phase 3: Analyze Complexity Factors
+> → Read references/complexity-factors.md for detailed code complexity, scope, risk factors, and estimation guidelines
+---
+## Phase 4: Generate the Estimate
+> → Read references/estimate-template.md for the full estimate output template
+Output the estimate with a brief summary: recommended budget, confidence level, and the single biggest risk factor.
+This skill is read-only — no files are written. Verdict: **COMPLETE** — estimate generated.
+---
+## Phase 5: Next Steps
+- If confidence is Low: recommend a time-boxed spike (`/prototype`) before committing.
+- If the task is > 10 days: recommend breaking it into smaller stories via `/create-stories`.
+- To schedule the task: run `/sprint-plan update` to add it to the next sprint.

package/skills/estimate/references/complexity-factors.md ADDED Viewed

@@ -0,0 +1,30 @@
+# Complexity Factors & Guidelines
+## Code Complexity
+- Lines of code in affected files
+- Number of dependencies and coupling level
+- Whether this touches core/engine code vs leaf/feature code
+- Whether existing patterns can be followed or new patterns are needed
+## Scope
+- Number of systems touched
+- New code vs modification of existing code
+- Amount of new test coverage required
+- Data migration or configuration changes needed
+## Risk
+- New technology or unfamiliar libraries
+- Unclear or ambiguous requirements
+- Dependencies on unfinished work
+- Cross-system integration complexity
+- Performance sensitivity
+## Guidelines
+- Always give a range (optimistic / expected / pessimistic), never a single number
+- The recommended budget should be the expected estimate, not the optimistic one
+- Round to half-day increments — estimating in hours implies false precision for tasks longer than a day
+- Do not pad estimates silently — call out risk explicitly so the team can decide

package/skills/estimate/references/estimate-template.md ADDED Viewed

@@ -0,0 +1,60 @@
+# Estimate Output Template
+```markdown
+## Task Estimate: [Task Name]
+Generated: [Date]
+### Task Description
+[Restate the task clearly in 1-2 sentences]
+### Complexity Assessment
+| Factor | Assessment | Notes |
+|--------|-----------|-------|
+| Systems affected | [List] | [Core, gameplay, UI, etc.] |
+| Files likely modified | [Count] | [Key files listed below] |
+| New code vs modification | [Ratio] | |
+| Integration points | [Count] | [Which systems interact] |
+| Test coverage needed | [Low / Medium / High] | |
+| Existing patterns available | [Yes / Partial / No] | |
+**Key files likely affected:**
+- `[path/to/file1]` -- [what changes here]
+### Effort Estimate
+| Scenario | Days | Assumption |
+|----------|------|------------|
+| Optimistic | [X] | Everything goes right, no surprises |
+| Expected | [Y] | Normal pace, minor issues, one round of review |
+| Pessimistic | [Z] | Significant unknowns surface, blocked for a day |
+**Recommended budget: [Y days]**
+### Confidence: [High / Medium / Low]
+[Explain which factors drive the confidence level for this specific task.]
+### Risk Factors
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+### Dependencies
+| Dependency | Status | Impact if Delayed |
+|-----------|--------|-------------------|
+### Suggested Breakdown
+| # | Sub-task | Estimate | Notes |
+|---|----------|----------|-------|
+| 1 | [Research / spike] | [X days] | |
+| 2 | [Core implementation] | [X days] | |
+| 3 | [Testing and validation] | [X days] | |
+| | **Total** | **[Y days]** | |
+### Notes and Assumptions
+- [Key assumption that affects the estimate]
+- [Any caveats about scope boundaries]
+```