From f943633e46f16c9c6c714916f0a41e9ab5ded34c Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Mon, 26 Jan 2026 20:35:51 +0500 Subject: [PATCH 01/11] Update README.md --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index b983071..3749eb3 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,10 @@ your best ai assistant with the best practice - [claude --dangerously-skip-permissions] "defaultMode": "bypassPermissions" - *deprecated** [ultrathink] Triggers extended thinking with up to ~32K thinking tokens for a single request. +## CLAUDE CODE FEATURES INSPIRATION + +- [Claude Code Tasks - inspired by beats](https://www.reddit.com/r/ClaudeAI/comments/1qkjznp/anthropic_replaced_claude_codes_old_todos_with/) [Inspiration](https://github.com/steveyegge/beads) + ## DOCS ### **[docs/AGENTS.md](docs/AGENTS.md)** - Agent Orchestration Best Practices From f6a7d3463843a98d51f9f28844714fa1ce83b6e7 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 12:21:05 +0500 Subject: [PATCH 02/11] Update README.md --- README.md | 34 +++++++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 3749eb3..c14eca9 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,26 @@ your best ai assistant with the best practice ## LESSON LEARNED +### My Experience + +- **Workflows** +- Claude.md should be 100 lines only. +- Have feature specific subagents (extra context) with skills (progressive disclosure). +- /memory, /rules, constitution.md does not guarentee anything +- do manual /compact at max 50% +- subtasks should be so small that it can be completed in less than 50% session of context window +- always start with plan mode +- use human pass gated todo list workflow +- vanilla cc is better than 3rd party workflows +- **Utilities** +- status line, voice hooks +- never use dangerously—skip--permissions +- **Debugging** +- /doctor +- always ask claude to run the terminal (you want to see logs of) as a background task for better debugging +- use mcp (claude in chrome, playwright, chrome dev tool) to let claude see chrome console logs on its own + + ### Context Engineering - [Humanlayer - Writing a good Claude.Md](https://www.humanlayer.dev/blog/writing-a-good-claude-md) @@ -30,8 +50,11 @@ your best ai assistant with the best practice ### Workflows - [Ralph plugin with sandbox](https://www.youtube.com/watch?v=eAtvoGlpeRU) -- [RPI - Research Plan Implement](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents/blob/main/ace-fca.md) +- [Human Layer RPI - Research Plan Implement](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents/blob/main/ace-fca.md) - [AgentOs - 2026 its overkill (Brian Casel)](https://www.youtube.com/watch?v=0hdFJA-ho3c) +- [Github Speckit](https://github.com/github/spec-kit) +- [GSD - Get Shit Done](https://github.com/glittercowboy/get-shit-done) +- [OpenSpec OPSX](https://github.com/Fission-AI/OpenSpec/blob/main/docs/opsx.md) ## LIBRARIES @@ -40,13 +63,22 @@ your best ai assistant with the best practice ## KEYWORDS +### Claude Keywords - [btw] start prompt with btw to let the current task executing in background - [claude --dangerously-skip-permissions] "defaultMode": "bypassPermissions" - *deprecated** [ultrathink] Triggers extended thinking with up to ~32K thinking tokens for a single request. +### Community +- Vibe Coding +- Context Engineering +- Context Rot +- Dumb Zone + + ## CLAUDE CODE FEATURES INSPIRATION - [Claude Code Tasks - inspired by beats](https://www.reddit.com/r/ClaudeAI/comments/1qkjznp/anthropic_replaced_claude_codes_old_todos_with/) [Inspiration](https://github.com/steveyegge/beads) +- [Ralph Plugin](https://x.com/GeoffreyHuntley/status/2015031262692753449) ## DOCS From 8761c4ad82350df783719ebc94db6170d7f7bf31 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 12:29:24 +0500 Subject: [PATCH 03/11] Update README.md --- README.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index c14eca9..726ce4d 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ your best ai assistant with the best practice ### My Experience -- **Workflows** +■ **Workflows** - Claude.md should be 100 lines only. - Have feature specific subagents (extra context) with skills (progressive disclosure). - /memory, /rules, constitution.md does not guarentee anything @@ -32,10 +32,13 @@ your best ai assistant with the best practice - always start with plan mode - use human pass gated todo list workflow - vanilla cc is better than 3rd party workflows -- **Utilities** -- status line, voice hooks -- never use dangerously—skip--permissions -- **Debugging** +■ **Utilities** +- wispr-flow for voice prompting (10x productivity) +- voice hooks for claude feedback +- status line for glancing compact +- use git worktress +- use /config dont ask permission mode instead of dangerously—skip--permissions +■ **Debugging** - /doctor - always ask claude to run the terminal (you want to see logs of) as a background task for better debugging - use mcp (claude in chrome, playwright, chrome dev tool) to let claude see chrome console logs on its own @@ -55,6 +58,7 @@ your best ai assistant with the best practice - [Github Speckit](https://github.com/github/spec-kit) - [GSD - Get Shit Done](https://github.com/glittercowboy/get-shit-done) - [OpenSpec OPSX](https://github.com/Fission-AI/OpenSpec/blob/main/docs/opsx.md) +- [Superpower](https://github.com/obra/superpowers) ## LIBRARIES From 9aa09fb217a509fd7f8610236af5956164359d85 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 12:39:09 +0500 Subject: [PATCH 04/11] Update README.md --- README.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 726ce4d..90760a6 100644 --- a/README.md +++ b/README.md @@ -32,12 +32,14 @@ your best ai assistant with the best practice - always start with plan mode - use human pass gated todo list workflow - vanilla cc is better than 3rd party workflows + ■ **Utilities** - wispr-flow for voice prompting (10x productivity) - voice hooks for claude feedback - status line for glancing compact - use git worktress - use /config dont ask permission mode instead of dangerously—skip--permissions + ■ **Debugging** - /doctor - always ask claude to run the terminal (you want to see logs of) as a background task for better debugging @@ -73,11 +75,18 @@ your best ai assistant with the best practice - *deprecated** [ultrathink] Triggers extended thinking with up to ~32K thinking tokens for a single request. ### Community -- Vibe Coding +- Agentic Workflow +- AI Slop - Context Engineering - Context Rot - Dumb Zone - +- Hallucination +- One Shot +- Rate Limit Jail / Cooldown +- Slot Machine Method = Save state → let Claude run → revert if bad results → try again +- The Holy Trinity = Skills + Agents + Hooks working together +- Token Burn +- Vibe Coding ## CLAUDE CODE FEATURES INSPIRATION From 70087b4272634b90c2b9437c96fed9f048cd4e88 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 12:43:20 +0500 Subject: [PATCH 05/11] Remove debugging section from README Removed debugging tips from the README. --- README.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/README.md b/README.md index 90760a6..cc890c9 100644 --- a/README.md +++ b/README.md @@ -49,10 +49,6 @@ your best ai assistant with the best practice ### Context Engineering - [Humanlayer - Writing a good Claude.Md](https://www.humanlayer.dev/blog/writing-a-good-claude-md) -### Debugging -- always ask claude to run the terminal (you want to see logs of) as a background task for better debugging -- use claude in chrome to let claude see chrome console logs on its own - ### Workflows - [Ralph plugin with sandbox](https://www.youtube.com/watch?v=eAtvoGlpeRU) - [Human Layer RPI - Research Plan Implement](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents/blob/main/ace-fca.md) From 52d94e9a1fdd3b3b8c0e80bc5d92d43a5587a96e Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 12:51:47 +0500 Subject: [PATCH 06/11] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cc890c9..36fcc67 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ your best ai assistant with the best practice - /doctor - always ask claude to run the terminal (you want to see logs of) as a background task for better debugging - use mcp (claude in chrome, playwright, chrome dev tool) to let claude see chrome console logs on its own - +- provide screenshots of the issue ### Context Engineering - [Humanlayer - Writing a good Claude.Md](https://www.humanlayer.dev/blog/writing-a-good-claude-md) From bb188b5c47742611bf64c08b90f2ca8828c66a2a Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 13:05:50 +0500 Subject: [PATCH 07/11] Add SECURITY section to README Add a SECURITY section with a link to a talk on AI exploitation. --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 36fcc67..d19e383 100644 --- a/README.md +++ b/README.md @@ -89,6 +89,10 @@ your best ai assistant with the best practice - [Claude Code Tasks - inspired by beats](https://www.reddit.com/r/ClaudeAI/comments/1qkjznp/anthropic_replaced_claude_codes_old_todos_with/) [Inspiration](https://github.com/steveyegge/beads) - [Ralph Plugin](https://x.com/GeoffreyHuntley/status/2015031262692753449) +## SECURITY + +- [Great talk at 39C3 on "Agentic ProbLLMs: Exploiting AI Computer-Use and Coding Agents"](https://www.reddit.com/r/cybersecurity/comments/1qannih/great_talk_at_39c3_on_agentic_probllms_exploiting/) + ## DOCS ### **[docs/AGENTS.md](docs/AGENTS.md)** - Agent Orchestration Best Practices From 2038653a8a1d10cf387accc9c4c95c26d71e0287 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 13:44:21 +0500 Subject: [PATCH 08/11] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index d19e383..89579bb 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,7 @@ your best ai assistant with the best practice - vanilla cc is better than 3rd party workflows ■ **Utilities** +- terminal instead of ide (crash issue) - wispr-flow for voice prompting (10x productivity) - voice hooks for claude feedback - status line for glancing compact From 3c7924708c4580b0c9e13d3f9d167c9cf56d3f4e Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 13:49:14 +0500 Subject: [PATCH 09/11] Update README.md --- README.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 89579bb..c701e69 100644 --- a/README.md +++ b/README.md @@ -21,23 +21,23 @@ your best ai assistant with the best practice ## LESSON LEARNED -### My Experience +### My Experience (4 months) ■ **Workflows** -- Claude.md should be 100 lines only. -- Have feature specific subagents (extra context) with skills (progressive disclosure). +- Claude.md should not exceed 150+ lines. (still not 100% guarenteed) +- have feature specific subagents (extra context) with skills (progressive disclosure) instead of general qa, backend engineer. - /memory, /rules, constitution.md does not guarentee anything - do manual /compact at max 50% -- subtasks should be so small that it can be completed in less than 50% session of context window - always start with plan mode - use human pass gated todo list workflow -- vanilla cc is better than 3rd party workflows +- subtasks should be so small that it can be completed in less than 50% context +- vanilla cc is better than any workflows with smaller tasks ■ **Utilities** -- terminal instead of ide (crash issue) -- wispr-flow for voice prompting (10x productivity) -- voice hooks for claude feedback -- status line for glancing compact +- iTerm terminal instead of IDE (crash issue) +- Wispr Flow for voice prompting (10x productivity) +- claude-code-voice-hooks for claude feedback +- status line for context awareness and fast compacting - use git worktress - use /config dont ask permission mode instead of dangerously—skip--permissions From 3ce1f8398fee5c7ed0aca2bb67b42e4cebb2c33a Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 13:49:30 +0500 Subject: [PATCH 10/11] Update 'My Experience' section in README Removed the duration from the 'My Experience' section and clarified workflows. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c701e69..70fc179 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,7 @@ your best ai assistant with the best practice ## LESSON LEARNED -### My Experience (4 months) +### My Experience ■ **Workflows** - Claude.md should not exceed 150+ lines. (still not 100% guarenteed) From a0e026420113ed636e5f5cbe4f43849c4196e65e Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 27 Jan 2026 15:58:49 +0500 Subject: [PATCH 11/11] Update README with workflow guidelines --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 70fc179..e412db6 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,7 @@ your best ai assistant with the best practice ■ **Workflows** - Claude.md should not exceed 150+ lines. (still not 100% guarenteed) +- use commands for your workflows instead of agents - have feature specific subagents (extra context) with skills (progressive disclosure) instead of general qa, backend engineer. - /memory, /rules, constitution.md does not guarentee anything - do manual /compact at max 50%