gitwtfhub

wtf is noas-persona-loop?

noashavit/noas-persona-loop — explained in plain English

Analysis updated 2026-05-18

2Audience · pm founderComplexity · 2/5Setup · easy

TL;DR

A Claude Code skill set that builds audience personas from real observed behavior and uses them to judge and predict content performance before you ship it.

Mindmap

mindmap
  root((repo))
    What it does
      Builds personas from evidence
      Judges drafts before publishing
      Scores predictions vs outcomes
    Tech stack
      Claude Code
      Markdown agent files
    Use cases
      Judge a blog post before publishing
      Predict ad or email performance
      Track persona bias over time
    Audience
      Marketers
      Founders
    Setup
      Clone repo
      Add your audience evidence

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build audience personas grounded in real analytics or engagement data instead of guesses.

REASON 2

Run a draft blog post, ad, or email past your personas before publishing it.

REASON 3

Score each persona's prediction against real results and correct its biases over time.

REASON 4

Judge product ideas or feature framing against how your actual audience has behaved.

What's in the stack?

Claude CodeMarkdown

How it stacks up

noashavit/noas-persona-loop0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPython
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencepm foundergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Claude Code plus some real audience evidence, such as analytics exports, before personas can be built.

Wtf does this do

Noas Persona Loop is a set of Claude Code skills that build audience personas from real observed behavior, then use those personas to judge your work before you publish it. The pitch is that most marketing personas are made up from demographics and guesses, like a fictional Jordan who supposedly cares about developer experience with no actual evidence backing that claim. This project instead grounds every persona trait in real evidence you provide, such as analytics exports, spreadsheets, or screenshots of past engagement. The system works as a loop made of three skills. The first, persona build, interviews you and reads whatever evidence you have collected, then writes out persona files as markdown documents. The second, persona judge, runs a draft of whatever you are about to publish, whether that is a blog post, ad copy, email, or product idea, past each persona and produces a verdict along with a specific testable prediction about how it will perform. The third, persona learn, takes the real results once your content goes out into the world and scores each persona's earlier prediction against what actually happened, updating the persona file with any biases it discovers. Everything in the project is plain markdown files: agent files that define each persona, skill files that run the three step process, and data file templates where you paste in your own audience evidence. Nothing here is a hosted service or app, it all runs inside Claude Code on your own machine, and your actual audience data stays local and is excluded from version control by default. To use it you need Claude Code installed and some record of how your real audience behaves, even a small one such as thirty engaged people across five to ten past posts. You clone the repository, drop your evidence into a folder, then run the persona build command to generate your first set of personas.

Yoink these prompts

Prompt 1
Help me run /persona-build using the audience evidence I've collected in the audience folder.
Prompt 2
Use /persona-judge to evaluate this draft blog post before I publish it.
Prompt 3
Run /persona-learn on these real engagement results to update my persona biases.
Prompt 4
Explain how noas-persona-loop grounds personas in observed behavior instead of demographics.
Prompt 5
Help me collect the right kind of evidence for building a persona with this framework.

Frequently asked questions

wtf is noas-persona-loop?

A Claude Code skill set that builds audience personas from real observed behavior and uses them to judge and predict content performance before you ship it.

How hard is noas-persona-loop to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is noas-persona-loop for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.