| Add New Package Paths to mypy Configuration |
lesson |
tools |
active |
mypy Can't find package errornew workspace package mypy failuremypy_path missing new packagetype checking fails after adding packageadd package to mypy.ini |
src |
| Agent Credential Management |
lesson |
workflow |
active |
manage API keysOAuth blocked at passwordAPI key for agent workspacestore credentials in .env |
src |
| Agent Event Watch Workflow |
lesson |
autonomous |
active |
named watch taskwatch for event results |
src |
| Agent Orchestrator Patterns |
lesson |
workflow |
active |
orchestratormulti-agentstandup missingagent coordinationinference utilization |
src |
| Agent Workspace Maintenance |
lesson |
workflow |
active |
update gptme-contrib |
src |
| Agent Workspace Setup |
lesson |
workflow |
archived |
setting up new agent workspaceinitialize gptme agent from templatenew agent from gptme-agent-template |
src |
| Always Branch From Remote Master |
lesson |
workflow |
active |
create branchgit checkout -b |
src |
| Always Use Absolute Paths for Workspace Files |
lesson |
workflow |
active |
save file towrite journal entrymkdir -p journalfile pathwrong directory |
src |
| Autonomous Operation Safety |
lesson |
autonomous |
active |
lethal trifectaprivate datauntrusted contentexternal communicationprompt injection |
src |
| Autonomous Session Pivot Strategies |
lesson |
autonomous |
active |
pivot when blockedswitch tasks when stuckalternative value-creation |
src |
| Autonomous Session Structure |
lesson |
autonomous |
active |
4-phase sessionsession phase planningstructured autonomous sessionautonomous work phases |
src |
| Avoid Deeply Nested Code Structures |
lesson |
patterns |
active |
deeply nesteddeep nestingnesting levels |
src |
| Avoid Excessive Setup When Testing Components |
lesson |
patterns |
active |
spending too much time on setup5+ chains on prerequisitesneed to understand full pipeline before testing |
src |
| Avoid Long Try/Catch Blocks |
lesson |
patterns |
active |
except Exception:except Exception as ebare exceptbroad exceptbroad exception |
src |
| Blocked Period Status Check Trap |
lesson |
autonomous |
active |
blocked periodstatus check |
src |
| Bold Refactoring |
lesson |
workflow |
active |
adding new code without refactoringproposing refactoring without doing itshared module created but not usedPR adds code without removing oldrefactor when adding abstraction |
src |
| Browser Verification for Web Changes |
lesson |
tools |
active |
commit web changes without testingpush without browser checkclaiming fixed without testingjavascript fix without testing |
src |
| CI Failure Resolution and Pre-commit Infrastructure Maintenance |
lesson |
workflow |
active |
multiple consecutive CI failures on masterrestore corrupted pre-commit scriptsprek run failing with persistent errorsCI status red on master branch |
src |
| Check CLI --help Before Reading Source Code |
lesson |
tools |
active |
doesn't have a flag forwrap the command to addbefore patching the wrapper |
src |
| Check for Existing PRs Before Creating |
lesson |
workflow |
archived |
gh api graphql |
src |
| Clean PR Creation |
lesson |
workflow |
active |
messy PRunrelated commitsclean PRcherry-pick commitsPR hygiene |
src |
| Close the Loop |
lesson |
patterns |
active |
reduce human intervention in autonomous workflowsmake agents more autonomousautomate the feedback loopautonomous long-running tasksminimize human touchpoints |
src |
| Code Coverage Principle |
lesson |
workflow |
archived |
add teststest coveragewrite tests forpytest coveragemissing tests |
src |
| Communication Loop Closure Patterns |
lesson |
workflow |
active |
close the communication looprespond in the original threadconfirm the fix in the issuecompleted the work but did notmarked as done without commenting |
src |
| Configure pytest pythonpath for Monorepo |
lesson |
tools |
active |
pytest ModuleNotFoundErrortests fail to importpytest pythonpathworkspace package not foundcannot import in tests |
src |
| Cross-Agent Workspace Review |
lesson |
workflow |
active |
cross-agent reviewworkspace review patternsreviewing other agent's work |
src |
| Data Loader PR Quality Patterns |
lesson |
patterns |
active |
file not found |
src |
| Detect and Break Repetitive Action Loops |
lesson |
patterns |
active |
posting same comment multiple times in loopagent stuck in endless retry cyclerepeating failed action without progressdetected repetitive tool calls |
src |
| Documentation Principle |
lesson |
workflow |
active |
let me document thisworth documentingcreate a knowledge articleupdate the knowledge basedocument the finding |
src |
| Effective Autonomous Work Execution |
lesson |
autonomous |
active |
autonomous session |
src |
| Escalation vs Autonomy Decision Framework |
lesson |
autonomous |
active |
should I ask the user or proceed autonomouslyuncertain whether to escalate or decideneed human review before proceedingrisky action requiring approvalirreversible change decision point |
src |
| Fork PR Secrets Access |
lesson |
workflow |
active |
fork PR secretsfork CI missing secretspush directly to org |
src |
| GEPA-Based Lesson Optimization |
lesson |
concepts |
active |
gepa-lesson-optimizergepa optimizerbottom performing lesson |
src |
| Git Commit Message Format |
lesson |
workflow |
active |
conventional commitscommit message formatwrite commit messagecommit type prefixfeat fix docs commit |
src |
| Git Workflow |
lesson |
workflow |
active |
never use git add . or git commit -astage only intended files explicitlycommit trivial docs directly to masteraccidental staging of unintended filessubmodule update sequence |
src |
| Git Worktree Workflow for External Repositories |
lesson |
workflow |
active |
git worktreeworktreesubmit PR to externalPR to gptmebranch from origin/master |
src |
| GitHub Comment Formatting for File References |
lesson |
communication |
active |
github comment formattingfile reference linkclickable file link |
src |
| GitHub Issue Follow-Through Pattern |
lesson |
communication |
deprecated |
issue follow-throughclose communication looprespond after completingconfirm completion in threadmissing follow-up response |
src |
| GitHub Issue and PR Engagement |
lesson |
social |
active |
about to create new issueduplicate issue preventionsearch existing issues firstcheck for similar issuesupdate issue after work |
src |
| Hierarchical Context Management (Droid Architecture) |
lesson |
concepts |
active |
context window managementorganize context across stepsprune older conversation context |
src |
| Indexed Knowledge Base Pattern for LLM Retrieval |
lesson |
patterns |
active |
knowledge retrieval |
src |
| Inter-Agent Communication |
lesson |
workflow |
active |
inter-agent communicationagent-to-agent messagingcross-agent coordination |
src |
| LLMLingua (Compression Technique) |
lesson |
concepts |
deprecated |
llmlinguallmlingua compressionprompt compression technique |
src |
| Lesson Quality Standards |
lesson |
autonomous |
active |
lesson qualitydated lesson variants |
src |
| Linear API Integration |
lesson |
tools |
active |
query Linear issueslinear-activity.pyLINEAR_API_KEY not set |
src |
| Maintaining Readiness During Blocked Periods |
lesson |
autonomous |
deprecated |
maintaining readiness when blockedproductive while waitingblocked period activitiesall tasks blockedstrategic pause framework |
src |
| Making Progress Despite Blockers |
lesson |
workflow |
archived |
completely blockedneed human reviewwaiting for inputcannot proceedstuck on this |
src |
| Markdown Codeblock Syntax |
lesson |
tools |
active |
file content getting cut off mid-codeblockfiles ending with incomplete contentcodeblock without language tag causing parse errorssave operation truncating contentunclosed code block |
src |
| Match mypy Error Codes to Actual Error Type |
lesson |
tools |
active |
type: ignoremypy import errorimport-not-foundimport-untypedCannot find implementation or library stub |
src |
| Measure Before Optimize |
lesson |
workflow |
active |
should drop toshould be fasterneeds cachingadd cachingwithout a baseline |
src |
| Memory Failure Prevention |
lesson |
workflow |
archived |
memory failurecommunication loopsduplicate workcontext losssession handoff |
src |
| Multi-Issue Coordination Patterns |
lesson |
autonomous |
deprecated |
multiple tasks blockedall work waiting for reviewblocked across multiple issuesparallel blocked taskscoordinate blocked work |
src |
| Notion MCP Integration |
lesson |
tools |
active |
notion mcpnotion tokenNOTION_TOKEN |
src |
| PR Recovery After Accidental Closure |
lesson |
workflow |
active |
closed pr |
src |
| Persist Before Noting |
lesson |
patterns |
active |
noted for future referenceI'll remember thiswill keep this in mindgood to knowthanks for the clarification |
src |
| Pre-Issue Creation Checklist |
lesson |
workflow |
active |
duplicate preventionmemory failure |
src |
| Pre-Landing Self-Review |
lesson |
workflow |
active |
self-reviewpre-landingreview iterationcode reviewsubstantial change |
src |
| Pre-Mortem for Risky Actions |
lesson |
autonomous |
active |
pre-mortem for risky actionsforce push or destructive git operationmodifying production infrastructurerisk assessment before actionwhat could go wrong with this change |
src |
| Prefer Brain Repo Over Local Machine Memory |
lesson |
workflow |
active |
MEMORY.mdbrain repo |
src |
| Proactive Correction in Agent Messages |
lesson |
workflow |
active |
retract incorrect recommendationsent wrong advice to agentneed to correct prior messageearlier message was wrongsend a correction |
src |
| Progressive Disclosure for Documentation |
lesson |
patterns |
active |
documentation file consuming excessive context tokensalways-included file over 500 linescontext budget consumed by rarely-needed content |
src |
| Project Monitoring Session Patterns |
lesson |
workflow |
active |
structured monitoring triage workflowtriage notifications across reposmonitoring run derailing |
src |
| Python File Execution |
lesson |
tools |
active |
python script permission deniedchoose correct python execution methodshebang python execution |
src |
| Python Invocation |
lesson |
tools |
active |
bash: python: command not foundpython command not founduse python3 instead of pythonpython vs python3which python to use |
src |
| Read Full GitHub Context |
lesson |
workflow |
active |
--comments | tailgh issue view --comments |
src |
| Read PR Reviews Comprehensively |
lesson |
workflow |
active |
read ALL review sources without truncationreply to individual review comment threadsbatch all review replies in one shell blockmaintainer says you didn't address review commentsunresolved review threads on PR |
src |
| Requirement Validation Before Implementation |
lesson |
workflow |
active |
WHO requested this featureWHAT problem does this solvevalidate before implementingseems like a good idea without requesterbuilding before validating need |
src |
| Responding to Code Review Feedback |
lesson |
communication |
active |
received code review feedback on PRmaintainer requested changes on pull requestrespond to review feedbackaddress reviewer suggestionsreview feedback needs response |
src |
| Rule-Driven Session Gating for Monitoring Agents |
lesson |
autonomous |
active |
skip sessions when nothing to dolightweight check before spawningsession gating |
src |
| Run uv sync --all-packages After Workspace Changes |
lesson |
tools |
active |
ModuleNotFoundError workspace packagepackage not installed despite pyproject.tomluv workspace package missingcannot import workspace package after addinguv sync all packages after changes |
src |
| Safe Operation Patterns |
lesson |
autonomous |
active |
classify operation before executingsafe to execute autonomouslyrequires human approval |
src |
| Scope Discipline in Autonomous Work |
lesson |
autonomous |
active |
while working on X noticed Y could be improveddiscovered tangential improvement opportunityalso fixed some nearby code while at itscope creep during autonomous sessionscope creep |
src |
| Session Ending Protocol |
lesson |
workflow |
archived |
session completeending a sessionwrap up the sessionland the planesession ending checklist |
src |
| Session Startup Recent Actions Review |
lesson |
workflow |
active |
skipped recent actions reviewmissed previous session contextincomplete communication loopduplicate work from missing contextcontext gap from last session |
src |
| Shell Command Chaining |
lesson |
tools |
active |
environment variable lost between blocksshell blocks lose contextchain shell commandscommand chaining |
src |
| Shell Output Filtering for Token Efficiency |
lesson |
tools |
deprecated |
filter output with grep head tailcommand dumped 10k+ tokenslarge output 1000+ linestoken efficiency shell |
src |
| Shell Path Quoting for Spaces |
lesson |
tools |
active |
path with spaces |
src |
| Sibling Tool Call Errored Cascades from One Failed Tool in a Batch |
lesson |
tools |
active |
sibling tool call errored |
src |
| Simplify Before Optimize |
lesson |
patterns |
active |
let's add cachingadd a cachecache the resultsperformance optimizationpremature optimization |
src |
| Stage Files with git add Before Commit/prek |
lesson |
tools |
active |
pathspec did not matchnothing added to commitStashing unstagedprek shows old errorscommit untracked file |
src |
| Stated Intention Follow-Through |
lesson |
workflow |
active |
I'll submit a PRcomment promisingI'll fix thispromised tostated intention |
src |
| Strategic Completion Leverage When Blocked |
lesson |
autonomous |
archived |
blocked on externalwaiting for stakeholderexternal dependencies blockingstrategic value creationstrategic completion leverage |
src |
| Strategic Focus During Autonomous Sessions |
lesson |
autonomous |
active |
straying from highest-leveragetrapped in maintenance loopschurning on low-value taskslooking busy without shippingplateau detector says category_monotony |
src |
| Thompson Sampling for Work Category Optimization |
lesson |
autonomous |
deprecated |
implement thompson sampling for work categoriesbandit over work categoriesoptimizing session mode banditcategory selection explore exploitwork category bandit setup |
src |
| Tmux for Long-Running Processes |
lesson |
tools |
active |
process killed at 120 secondsshell timeout exceededtmux for long-running processprocess runs longer than 2 minutes120-second shell timeout |
src |
| Todoist MCP Integration |
lesson |
tools |
active |
todoisttodoist mcptodoist integrationtodoist apitodoist token |
src |
| Trajectory Persistence |
lesson |
infrastructure |
active |
delete trajectorydelete session datasession data retentiontrajectory filessession records |
src |
| Triggering Greptile PR Reviews |
lesson |
tools |
active |
greptile scoretrigger greptilefresh greptile reviewgreptile after fixinggreptile re-review |
src |
| Using ast-grep for Code Refactoring |
lesson |
tools |
active |
sg run --patternast-grep structural searchcode refactoring across files |
src |
| Verifiable Tasks Principle |
lesson |
workflow |
active |
how do I know when this is doneno way to verifyunclear completion criteriatask success is unclear |
src |
| When to Rebase PRs |
lesson |
workflow |
active |
commits behind⟳ behind⚠ CONFLICTSmergeable=falserebase based on behind count |
src |
| Worktree Push Trap: Accidentally Pushing Feature Commits to Master |
lesson |
workflow |
active |
git worktree addgit push -u originbranch from masterpush.default=upstream |
src |
| gh pr checks --watch Exits 8 for Pending Checks (Not a Failure) |
lesson |
tools |
active |
exit code 8waiting for checks |
src |
| gh-pr-review Extension for Review Thread Management |
lesson |
tools |
archived |
resolve review threadresolve review commentreview threadsgh-pr-reviewclose conversation thread |
src |
| gptme-contrib Contribution Pattern |
lesson |
workflow |
active |
contrib PR |
src |
| mcp-cli for Token-Efficient MCP Interactions |
lesson |
tools |
active |
mcp-climcp cliMCP tokenMCP contextlazy MCP |
src |
| agent-onboarding |
skill |
skill |
active |
|
src |
| artifact-publishing |
skill |
skill |
active |
|
src |
| code-review-helper |
skill |
skill |
active |
|
src |
| gptme-wrapped |
skill |
skill |
active |
|
src |
| home-assistant |
skill |
skill |
active |
|
src |
| plugin-development |
skill |
skill |
active |
|
src |
| progressive-disclosure |
skill |
skill |
active |
|
src |
| project-setup-interview |
skill |
skill |
active |
|
src |
| rewrite-soul |
skill |
skill |
active |
|
src |
| template-skill |
skill |
skill |
active |
|
src |