explaingit

noashavit/noas-persona-loop

Analysis updated 2026-05-18

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

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

Claude CodeMarkdown

How does it compare?

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 get it running?

Difficulty · easy Time to first run · 30min

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

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.