Skip to content

AGENTS.md

Latest commit

 

History

History
41 lines (32 loc) · 2.1 KB

AGENTS.md

File metadata and controls

41 lines (32 loc) · 2.1 KB

AGENTS.md — JetThoughts Blog

Canonical instructions live in CLAUDE.md. Read that first. Session start: always read @docs/workflows/BASE_HANDBOOK.md and @docs/workflows/flow-router.md.

ICP (MANDATORY for content/design/marketing work): Read docs/90-99-content-strategy/strategy-analysis/90.10-icp-primary-website-target.md before writing blog posts, designing pages, planning content, or creating marketing materials. Target audience: non-technical founder burned by a devshop.

Voice (MANDATORY when writing): Read docs/90-99-content-strategy/strategy-analysis/90.11-voice-guide.md.

  • Founder posts: Rob Walling directness + Rand Fishkin vulnerability. Plain English, empathy, specific numbers.
  • Tech posts: Thoughtbot style. Open with tension not features. Own opinions. Code as narrative evidence. Honest tradeoffs.
  • Run the stream-specific self-test checklist before publishing.

Finding posts to reference (MANDATORY when writing blog posts): Use claude-context MCP search first: Search the codebase at /Users/pftg/dev/jetthoughts.github.io for: "topic keywords". For tag/slug lookups see docs/blog-post-index.md. Never guess slugs — verify with ls content/blog/<slug>/index.md.

Workflow references:

  • docs/workflows/css-consolidation.md
  • docs/workflows/blog-pipeline.md
  • docs/workflows/cover-images.md (canonical spec in .stitch/design.md)
  • docs/workflows/commands.md
  • docs/workflows/agents.md

Key commands:

  • bin/hugo-build
  • bin/rake test:critical

OUTPUT STYLE: expert-terse

  • Telegraph format: subject-verb-object, drop articles/prepositions
  • Symbolic vocabulary: → cause, ∵ because, ∴ therefore, ⊕ add, ⊖ remove, Δ change, ≈ similar, ≠ different, ∈ in/member, ∅ empty/none, ✓ ok, ✗ fail
  • Code blocks: untouched (never compress code syntax)
  • Each line: max 80 chars
  • Zero narration, zero filler
  • BUDGET: ≤100 tokens per non-code response

lean-ctx

Prefer lean-ctx MCP tools over native equivalents for token savings. Full rules: @LEAN-CTX.md