docs(design): add messaging angles research and update Show HN draft

[rapiercraft-forge]

Summary

Research deliverable for #1092: cross-platform analysis of which 'Codebase LLM Wiki' messaging angles get the most developer traction.

Key finding: Karpathy's LLM Wiki gist (April 2026) reached 17M views, 5K stars, 4K forks — the "LLM Wiki" / "Codebase Wiki for AI Agents" vocabulary has massive organic developer awareness. "Agent memory" framing dominates adoption metrics (Mem0 48K stars, Stack Overflow 2025: 66% cite context loss as #1 frustration).

Changes

• docs/design/messaging-angles-research.md — New: full ranked analysis of 5 candidate positioning angles with evidence, engagement data, and recommended messaging stack
• docs/design/show-hn-draft.md — Updated: added research-backed title options D/E, revised maker comment to use LLM Wiki/memory vocabulary

Recommended Messaging Stack (from research)

Layer	Copy
Hero Headline	"Your AI agents forget everything. ForgeDock gives them memory that lives in GitHub."
Show HN Title	"Show HN: ForgeDock — Codebase LLM Wiki for AI agents, built on GitHub Issues"
Technical Subtitle	"The context engineering layer for autonomous AI pipelines."

Testing

• Review messaging-angles-research.md recommendations align with brand voice [type:manual]
• Validate Show HN title options against HN character limit [type:manual]

---

Closes #1092
Implementation branch: feat/messaging-angles-research-1092
Base: staging

[rapiercraft-forge]

General Security & Quality Scan — PR #1102

Reviewer: General Security Agent (SEC)
Commit reviewed: b99fc74
Files: docs/design/messaging-angles-research.md, docs/design/show-hn-draft.md

Diff Review

PR changes 2 markdown documentation files in docs/design/. No executable code, no infrastructure configuration, no environment variables, no secrets, no SQL, no dependencies.

messaging-angles-research.md

• New file: 179 lines of strategy research documentation
• References to external URLs (GitHub gists, Stack Overflow survey, HN links) — informational only, no hyperlink injection risk in markdown docs
• Statistical claims cite sources — appropriate for internal documentation
• No credentials, tokens, or API keys embedded

show-hn-draft.md

• Updated file: adds Options D/E (new recommended HN title variants), updates Maker Comment
• Contains no code, no configuration, no secrets
• 'token' references are to LLM context tokens (informational content)
• 'eval' substring appears in 'evaluated' (English word, not a code expression)

Security Findings

No security findings. This PR contains only markdown documentation with no code, configuration, secrets, or infrastructure changes.

Quality Observations

The research document properly cites sources with URLs and provides quantitative evidence for claims (GitHub stars, survey percentages, engagement metrics). Appropriate for internal strategic documentation.

---

[rapiercraft-forge]

APPROVED: commit b99fc74 after context-aware review (1 agent: General Security). 0 findings created as issues. Safe to merge.

Domains: DOCS (documentation only)
Automated checks: PASS — no Python/TypeScript/SQL/env-var/secrets issues (pure markdown PR)
Integration checks (Phase 2.5): PASS — no activation paths to verify (docs-only)
Risk signals: None detected (false positive matches were English words in marketing copy)

[rapiercraft-forge]

PR Review Summary: #1102 - docs(design): add messaging angles research and update Show HN draft

Review Integrity

Reviewed commit: b99fc74 | Current HEAD: b99fc74 | Status: CURRENT

Verdict: APPROVED

Context-Aware Review

Domains: DOCS (documentation-only PR — 2 markdown files) | Agents: 1 (General Security)

Integration Checks (Phase 2.5)

Code registration: PASS — docs-only, no activation paths
SOPS deploy chain: N/A — no env vars or infrastructure changes
Purpose Regression Gate (7A): N/A — non-milestone PR

Risk Matrix

Category	Risk	Blocking?	Confidence
Secrets/credentials	None	No	CONFIRMED clean
Code quality	N/A	No	Docs only
Security vulnerabilities	None	No	No executable code

Findings

Finding	Severity	Confidence	Issue
None	—	—	—

Automated Checks

Check	Result
Python lint/compile	SKIPPED — no Python files
TypeScript typecheck	SKIPPED — no TS files
Secrets detection	PASS — no credentials found
SQL validation	SKIPPED — no SQL files
Env var audit	PASS — no new env vars

Recommendation

Clean docs-only PR with well-researched content. Changes add strategic documentation (messaging research) and update an existing draft. No security concerns, no code changes, no infrastructure impact. Safe to merge.

---

Context-aware review complete. 1 agent + integration checks. 0 findings triaged. PR merged.

[rapiercraft-forge]

Graph Decision Record — Issue #1092 / PR #1102

{
  "schema_version": "1",
  "issue": 1092,
  "pr": 1102,
  "repo": "RapierCraftStudios/ForgeDock",
  "lane": "fast-lane",
  "pr_base": "staging",
  "branch": "feat/messaging-angles-research-1092",
  "head_sha": "b99fc743307a2d0ec694b97037d4514cbdf04741",
  "merge_commit": "833c337a07849e7a7ec296c5bd50175d32b6465f",
  "investigation": {
    "verdict": "CONFIRMED",
    "confidence": "HIGH",
    "task_type": "Investigation"
  },
  "context": {
    "historical_edges_referenced": 0,
    "forge_annotations_read": ["FORGE:INVESTIGATOR", "FORGE:FAST_PATH", "FORGE:BUILDER"]
  },
  "build": {
    "files_changed": 2,
    "quality_gate": "skipped",
    "quality_gate_iterations": 0
  },
  "review": {
    "verdict": "APPROVED",
    "findings_created": 0,
    "agents_run": 1
  },
  "merge": {
    "merged_at": "2026-06-25T10:28:44Z",
    "justification": "Investigation confirmed (CONFIRMED/HIGH), docs-only PR, security review approved, 0 findings"
  }
}

Queryable: gh api repos/RapierCraftStudios/ForgeDock/issues/1102/comments --jq '[.[] | select(.body | contains("FORGE:DECISION_RECORD"))] | .[0].body