Skip to content
Skillpedia
Writing280k · #199

growth-log

Writes learning logs that extract patterns from completed tasks. It helps document lessons learned and identify transferable rules for the future.

What it does

This guide teaches how to log learnings in a way that you can reuse the knowledge in the future. Instead of noting what happened, you identify the pattern behind the event, the root cause, and how to recognize similar situations.

When to use it

  • ✓After finishing a complex task.
  • ✓After making a mistake or something went wrong.
  • ✓When reviewing what you learned over a period.

Example of what to ask your AI

“How can I log the learning from when my code broke due to a browser change?”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/affaan-m/ECC/blob/main/skills/growth-log/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/affaan-m/ECC/blob/main/skills/growth-log/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The AI helps transform specific events into reusable patterns. It guides you to identify the root cause, the rule that can be applied in other situations, and a signal to recognize when this pattern might appear again.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add affaan-m/ECC --skill growth-log

Or download just the file:

curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/growth-log/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Growth Log Skill

The problem: Most people write "fixed a bug in X" as a learning log. That's a diary entry, not a learning artifact. A real growth log extracts the pattern so you recognize it next time.

This skill teaches: How to write learning entries that compound across sessions. Works with any note-taking system — Markdown files, Notion, Obsidian, plain text. Templates are generic; adapt to your setup.

When to Activate

  • After completing a complex task (multi-file, new feature, architecture change)
  • After a failure, mistake, or "that was harder than expected" moment
  • When you want to review what you've learned over a period

When NOT to activate: Trivial changes (typo fixes, single-line tweaks, config value changes with no debugging). The threshold: did this task involve debugging, redoing, rollback, or a non-obvious decision? If yes → write an entry. If no → skip.

The Three Rules

Rule 1: Failures > Achievements

A failure is nutritionally denser than a success. One bug that took 2 hours to find teaches more than 3 features that worked first try.

Bad: "Successfully implemented the login flow." Good (web dev): "Login flow: session token wasn't persisting because the cookie SameSite defaulted to Lax in Chrome 128+. Pattern: always explicitly set SameSite=None; Secure when cross-origin. Signal to recognize: auth breaks after browser upgrade or when crossing origin boundaries." Good (data pipeline): "CSV import failed silently on empty rows because pandas.read_csv(dropna=False) keeps zero-width rows that len() counts as valid. Pattern: always df.dropna(how='all', inplace=True) before row-count validation."

Rule 2: The Bole Principle (伯乐原则)

Before writing a new entry, ask: "Is this fundamentally the same as something I already recorded?"

Same root cause, different symptom → merge, don't duplicate. New root cause → new entry.

How to check: Search existing entries for keywords from your root cause before writing. If you find a match, add your new symptom as an additional example under the existing entry rather than creating a duplicate.

Example: "Forgot to update the output index after creating a file" and "Forgot to update skill ratings after a task" — same root cause (no automatic capture trigger). Merge into one entry about "post-task capture gaps."

Rule 3: Must Be Transferable

Every entry must answer: "Next time I face a similar situation, what do I do differently?"

If you can't write that sentence, you haven't extracted the pattern yet.

How to extract a pattern from a concrete event:

  1. State what happened in one sentence
  2. Ask "why?" iteratively until you reach root cause (usually 3-5 whys)
  3. Generalize: "What class of problem is this?" (not "Chrome 128 bug" but "browser default change breaking existing behavior")
  4. Formulate as: "Next time I see [signal], I will [action]."
  5. Name the signal: what specific observable tells you this pattern is active?

Entry Template

Scope: One entry per distinct root cause. Typical length: 4-8 sentences. If it takes >2 minutes to write, you're narrating events. If <30 seconds, you haven't gone deep enough.

## [Title: the pattern, not the event]

### Context
- What was I trying to do?
- What went wrong / what worked surprisingly well?

### Root Cause / Core Insight
- The underlying mechanism, not just the symptom

### The Pattern (transferable)
- Next time [similar situation], I will [specific action].
- Signal to recognize: [what observable tells me this pattern is active?]

### Related
- [entry-name](../path/to/related-entry.md)

Entry Types

All four types use the template above. The type determines which sections carry the most weight:

Type When to Use Emphasis Example Title
Failure Something broke, needed debugging, or required rework Root Cause "Config inheritance ≠ behavior inheritance across sessions"
Methodology A repeatable process emerged from the work Context / Pattern "PPT → open-book exam study guide: three-layer structure"
Pattern Discovery A reusable insight about tools, systems, or thinking Pattern section "PR description template: describe the gap, not the feature"
Capability Change A measurable skill improvement Context (before vs after) "Git: from clone/push to independent PR with 12 commits"

Quality Checklist

…

FAQ

Why focus on failures over successes?

Failures generally teach more, as they require investigation and reveal hidden mechanisms that easy successes do not show.

What is the 'Bole Principle'?

It's a reminder to check if a new learning is just a different symptom of an already recorded problem. If so, update the existing entry instead of creating a duplicate.

How do I ensure my log is useful for the future?

Always include a sentence stating: 'Next time [similar situation], I will [specific action].' This ensures the learning is transferable.

Details

Original description by the author

Write growth log entries that extract reusable patterns from completed work — root cause, transferable rule, and a recognizable signal — instead of diary-style event narration, with a 4-8 sentence template and merge-duplicates discipline. Use when capturing what was learned after a complex task, debugging session, failure, or rollback, when reviewing progress over a period, or when a delivery gate

repo: affaan-m/ECC

Popularity

GitHub stars
280k
Ranking position
#199
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills