productization-journal
Skill1 starsChanged 3 months agoMITView on GitHub
Capture workflows, templates, integrations, and process decisions as reusable product specs for future productization (SaaS, licensing, done-for-you services). Trigger on explicit requests — "log this", "document this workflow", "add to the product journal", "capture this for productization" — and as a hook during the weekly review ("what did I build this week that isn't in the journal?"). NOT an every-task auto-logger.
In this repository47 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- access-transfer-trackerSkill
- ai-3d-generatorSkill
- ai-asset-generatorSkill
- ai-demo-builderSkill
- apple-grade-designSkill
- brand-guide-builderSkill
- client-onboardingSkill
- cold-email-campaignSkill
- cold-emailSkill
- company-teardownSkill
- competitive-ads-extractorSkill
- content-calendarSkill
- content-repurposerSkill
- content-research-writerSkill
- content-strategySkill
- daily-briefSkill
- discovery-call-prepSkill
- email-composerSkill
- follow-up-nurtureSkill
- gbp-local-seoSkill
- hormozi-100m-leadsSkill
- interactive-website-builderSkill
- invoice-trackerSkill
- lead-flow-verifierSkill
- lead-scraperSkill
- mcp-integrationSkill
- meeting-listenerSkill
- post-purchase-email-seriesSkill
- proposal-generatorSkill
- prospect-workupSkill
- regulated-copy-complianceSkill
- retainer-reportingSkill
- review-managerSkill
- scroll-demo-builderSkill
- seo-auditSkill
- site-launch-cutoverSkill
- site-qa-checklistSkill
- social-media-auditorSkill
- social-media-managerSkill
- social-video-producerSkill
- stylized-3d-worldbuildingSkill
- video-analyzerSkill
- web-researchSkill
- website-builderSkill
- weekly-client-checkinSkill
- welcome-email-seriesSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Every workflow, template, integration, and decision documented here becomes blueprint material for a sellable product later.
- Distinctive: line 21
If one piece of work produced all three (a decision, a lesson, and a reusable system), each goes to its own home.
- Very specific: line 37
Every entry is a Markdown file in references/product-journal/entries/, named YYYY-MM-DD_short-descriptor.md (e.g.
- Distinctive: line 105
When building skills: check the journal first. If a new skill overlaps an existing entry, extend the system rather than duplicating it.
- Distinctive: line 117
Think in modules: Every entry hints at which product module it belongs to.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Productization Journal
Every workflow, template, integration, and decision documented here becomes blueprint material for a sellable product later. Capture what was built, why it works, what it replaced, and how it could be abstracted for any small business — not just the client that triggered it.
Lane definition (what goes where)
This journal is for reusable system specs — how a workflow/template/integration works and how it would generalize to another business. It is NOT the place for:
decisions/log.md— one-line business decisions with reasoning/context (no spec)..claude/rules/learned-rules.md— corrections and durable operating rules.- Memory files — session-to-session working context.
If one piece of work produced all three (a decision, a lesson, and a reusable system), each goes to its own home; the journal entry links the others rather than duplicating them.
When to log
- The operator explicitly asks: "log this", "document this workflow", "add to the product journal", "capture this for productization"
- Weekly review hook (the daily-brief skill's Friday review): ask "What did you build this week that isn't in the product journal?" and log the answers
- A deliverable format, client workflow, or integration is finalized in a form another business could benefit from — OFFER to log it; don't silently fire on every task
Entry schema
Every entry is a Markdown file in references/product-journal/entries/, named
YYYY-MM-DD_short-descriptor.md (e.g. 2026-03-18_review-management-workflow.md).
# [System Name]
**Date:** YYYY-MM-DD
**Origin:** [Which skill/workflow/project created this]
**Category:** [workflow | integration | template | skill | decision | edge-case | process]
**Client Context:** [Which client triggered this, or "internal"]
**Reusability Score:** [1-5 — 1 = very client-specific, 5 = works for any SMB]
## What It Does
[2-4 sentences. Specific about tools, files, and systems involved.]
## The Problem It Solves
[The pain point. Why it matters to a small business owner.]
## How It Works
- Trigger (what kicks off this workflow)
- Inputs (what data/context is needed)
- Process (what happens, in what order)
- Outputs (what the client or system gets)
- Tools involved (records workspace, <TASK SYSTEM>, MCP servers, hosting, email platform, etc.)
## Key Decisions & Why
[Tradeoffs, alternatives considered, why this approach won.]
## Productization Potential
[How this could become a standalone product or service — and the revenue model:
licensing, SaaS, template marketplace, done-for-you service.]
## Abstraction Notes
- What's hardcoded that should be configurable?
- What assumptions are baked in about this client/industry?
- What would a settings panel need to expose?
- What integrations would need to be swappable?
## Edge Cases & Gotchas
[What broke, what was unexpected, what to warn a future user about.]
## Dependencies
[Other systems, skills, or integrations this relies on.]
## Status
[active | deprecated | experimental | needs-refinement]INDEX convention
Maintain references/product-journal/INDEX.md: entries grouped By Category,
By Reusability Score, and a Product Module Map table
(Module | Core Entries | Status) that clusters related entries into future product
modules. Update the index in the same commit as the entry — an unindexed entry is
invisible.
CHANGELOG convention (quick-log)
For small updates that don't warrant a full entry, append to
references/product-journal/CHANGELOG.md:
## YYYY-MM-DD
- **[category]** Brief description of what changed and why. Reusability: X/5How the journal gets used
- When building skills: check the journal first. If a new skill overlaps an existing entry, extend the system rather than duplicating it.
- When pitching clients: high-scoring entries are upsells or add-ons.
- When planning products: quarterly, review 4-5-score entries and assess which could become paid products.
- When archiving projects: extract any reusable system as an entry BEFORE the
project moves to
archives/.
Behavior guidelines
- Be concrete, not abstract. Actual file paths, field names, prompt snippets, config details.
- Capture the "why" ruthlessly. The what is easy to reconstruct; the why disappears.
- Think in modules. Every entry hints at which product module it belongs to.
- Flag manual steps. Anywhere the operator is the bottleneck = a premium human-in-the-loop feature or a future automation target.
- Record the client's reaction. Client feedback on a workflow is paid product research.
- Version, don't overwrite. Updates get a new entry referencing the old one — the evolution tells you V1 vs V2.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

