Commit Graph

465 Commits

Author SHA1 Message Date
Shayan Rais b3a7e2decd presentation/learning-journey: rebuild slide 2 chip set with visual hierarchy
Introduce a hero tier (6 blue chips, ~1.55-1.6rem, weight 800, glow shadow)
and a supporting tier (12 chips across purple/green/amber, ~0.9-1.0rem, weight
600, softer shadow). Recolor agentic engineering, orchestration, dumb zone →
blue hero; recolor harness, compaction → purple supporting. Add new chip
"agentic workflows" as a blue hero chip. Randomize positions of all 18 chips
for natural distribution and breathing room.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 12:27:41 +05:00
Shayan Rais 69b51ec6a3 presentation/learning-journey: rename chip "short prompting" → "one-shot prompting" on slide 2
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 12:05:25 +05:00
Shayan Rais 017994b5e5 .claude/agents/presentation-learning-journey: record chip-splitting and color-rebalancing patterns
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 11:58:34 +05:00
Shayan Rais 705a681a4a presentation/learning-journey: split 2 combined chips into 4 on slide 2
Replaced `hallucination prompt engineering` with `hallucination` (amber)
and `prompt engineering` (green). Replaced `one shot AI slop` with
`short prompting` (amber) and `AI slop` (green). Slide 2 now shows 17
chips. Color distribution: 4 blue / 4 purple / 5 green / 4 amber — no
color exceeds 5. New chips placed in rows 1b and 3b with chaotic-scatter
positioning (-5° to +5° rotation, 0.95–1.05rem font sizes).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 11:57:14 +05:00
Shayan Rais 27df25fb04 .claude/agents/presentation-learning-journey: record word-cloud slide insertion methodology
Documents the absolute-position % chip pattern, 5-row layout strategy,
overflow:hidden container, white-space:nowrap requirement, and updated
section-divider positions after the slide-2 insertion (total 39 slides).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 11:30:54 +05:00
Shayan Rais 55c3ca1095 presentation/learning-journey: insert slide 2 AI jargon word-cloud
New slide 2 "Jargon you'll hear" — 15 scattered pill-chips (vibe coding,
agentic engineering, context engineering, context rot, dumb zone,
hallucination prompt engineering, progressive disclosure, orchestration,
token burn, context bloat, one shot AI slop, harness, MCP, hooks,
compaction) with varied sizes, rotations, and 4 colors (blue/purple/
green/amber). Existing slides 2-38 renumbered to 3-39; all goToSlide
targets and section banner comments updated accordingly. Total: 39 slides.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 11:27:50 +05:00
Shayan Rais c86880a227 .claude/agents/presentation-learning-journey: record slide-3 insertion methodology and sed/Edit sequencing rule
Self-evolve log entries from the Apr 18 "What is Claude Code?" slide
insertion: descending-sed renumber method, three-column inline-grid layout
choice, post-insertion section-divider positions (Agents=8 ... Workflow=34),
and the sequencing rule that Edit must run after sed completes — parallel
execution causes "file modified since read" errors.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 22:07:54 +05:00
Shayan Rais c3952d8e41 presentation/learning-journey: insert new slide 3 "What is Claude Code?" (Model + Harness + Tools)
Establishes the vocabulary (Model + Harness + Tools = Agent) before the deck
shows concrete examples. Three-column grid with color-coded cards explains
each layer for a non-technical audience, closed by a "Why This Matters"
callout with the Karachi time-zone example to make the harness/tools
distinction concrete.

Renumbers all subsequent slides (data-slide 3-37 → 4-38), updates all banner
comments, and shifts TOC goToSlide targets: Agents 7→8, Skills 13→14,
Context 19→20, CLAUDE.md 24→25, Commands 30→31. Total deck grew from 37 to
38 slides.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 22:07:48 +05:00
Shayan Rais 3c4eded305 updated 2026-04-18 21:58:56 +05:00
Shayan Rais 640071d4af presentation/learning-journey: stack slide 4 hallucination images and add "Fix Isn't Better Prompting" callout
Changed the slide-4 hallucination images from side-by-side to a vertically
stacked single-column grid capped at max-width 720px, and added a trigger-box
callout below them arguing that these failures (letter-counting, current date)
are fixed by structure — tools, CLAUDE.md, agents, skills — not by better
prompts. Turns the images into a forward-pointing motivation hook for the rest
of the session rather than a closed punchline.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 21:55:54 +05:00
Shayan Rais 1ffec30a37 presentation/assets: add current-year hallucination screenshot
Used on learning-journey slide 4 to illustrate Claude guessing the wrong year
— a knowledge-cutoff failure that motivates injecting context (CLAUDE.md,
MCP) rather than relying on better prompting.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 21:55:48 +05:00
Shayan Rais 9290cc6347 presentation/assets: add strawberry letter-count hallucination screenshot
Used on learning-journey slide 4 to illustrate Claude miscounting letters in
"strawberry" — a tokenization failure that motivates why tools (not prompts)
are the real fix.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 21:55:44 +05:00
Shayan Rais 5b4bd1aa41 presentation/learning-journey: reshape slide 3 as vibe-coding vs agentic-engineering contrast
Replaced slide 3's body with the TodoApp before/after project tree ported from
vibe-coding slide 2, removed the "Running Example" trigger-box (the learning-journey
deck uses a weather example, not TodoApp, so the promise didn't hold), and renamed
the heading to "Vibe Coding vs Agentic Engineering" so the slide reads as a
conceptual contrast rather than an example-project intro.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 21:46:54 +05:00
Shayan Rais b711123cdd changelog/development-workflows: record Apr 18 workflow table refresh
Logs star + count updates for ECC (158k→160k), Superpowers
(156k→159k), gstack (74k→76k, skills 46→37), GSD (54k→55k, agents
31→33), omc (29k→30k), CE (14k→15k, agents 49→50, commands 3→4,
skills 51→44), and OpenSpec (commands 10→11); 5 recurring count
discrepancies remain on hold pending manual verification.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:25:06 +05:00
Shayan Rais 4700bb6c95 changelog/concepts: record v2.1.113 CONCEPTS drift resolution (17 items)
Tracks Auto Mode flag removal, additions of Ultrareview and Tasks
rows, No Flicker Mode + Git Worktrees + Scheduled Tasks description
refreshes, /less-permission-prompts rename, and 10 verification
passes against the official sitemap.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:59 +05:00
Shayan Rais 7e7c2908d5 changelog/claude-subagents: v2.1.114 run — no drift
16 frontmatter fields and 5 built-in agents confirmed synchronized
with official docs.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:54 +05:00
Shayan Rais 915f983acc changelog/claude-skills: v2.1.114 run — no drift
14 frontmatter fields and 5 bundled skills confirmed synchronized
with official docs.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:51 +05:00
Shayan Rais 5768560421 changelog/claude-settings: record v2.1.114 drift resolution (14 items)
Tracks new settings (awaySummaryEnabled, externalEditorContext),
file-scope move for autoScrollEnabled, xhigh effort level, sandbox
denied-domains annotation cleanup, and two recurring OTEL env vars
kept on hold per Rule 8A/10B.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:48 +05:00
Shayan Rais d98e04fd90 changelog/claude-commands: record v2.1.114 drift resolution (10 items)
Logs the five new commands (/recap, /focus, /tui, /ultrareview,
/heapdump), four description updates (/review, /effort, /theme,
/model), and one new alias (/routines on /schedule).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:41 +05:00
Shayan Rais 77ac33fe58 best-practice/claude-subagents: bump badge to v2.1.114
Refreshes Last-Updated timestamp to Apr 18 2026 7:53 PM PKT and
version badge to v2.1.114. No drift detected — 16 frontmatter
fields and 5 built-in agents remain synchronized with official docs.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:36 +05:00
Shayan Rais 832b026191 best-practice/claude-skills: bump badge to v2.1.114, add xhigh effort level
Refreshes timestamp to Apr 18 2026 and adds xhigh to the valid
values for the skill-level effort override.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:31 +05:00
Shayan Rais e9b53ef82f best-practice/claude-settings: sync to v2.1.114
- add awaySummaryEnabled, externalEditorContext (v2.1.110)
- move autoScrollEnabled from General to Global Config
  (~/.claude.json) per official docs
- drop stale "not yet on official settings page" annotations from
  tui and sandbox.network.deniedDomains (both now documented;
  deniedDomains in v2.1.113)
- effortLevel: add xhigh (Opus 4.7, v2.1.111) and fallback note
- add CLAUDE_CODE_ENABLE_AWAY_SUMMARY env var
- bidirectional cross-links between settings report and
  claude-cli-startup-flags.md for CLAUDE_CODE_SIMPLE /
  CLAUDE_CODE_EFFORT_LEVEL
- quick-reference example uses the new keys

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:27 +05:00
Shayan Rais 6ab28bae8f best-practice/claude-commands: sync to v2.1.114 (70 → 75 commands)
- add /focus (v2.1.110), /tui (v2.1.110), /heapdump, /ultrareview
  (v2.1.111), /recap (v2.1.108)
- /effort: add xhigh level + interactive slider behavior (v2.1.111)
- /review: revert from deprecated → live built-in, cross-reference
  /ultrareview for cloud review
- /model: note mid-conversation switch warning (v2.1.108)
- /theme: add "Auto (match terminal)" option (v2.1.111)
- /schedule: add /routines alias

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:17 +05:00
Shayan Rais bbfa6b8894 settings.json: hoist disableAllHooks to top of file
Move disableAllHooks next to the opening brace so the master toggle
is visible at the top instead of buried below env and
enableAllProjectMcpServers. Behavior unchanged (remains false).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:10 +05:00
Shayan Rais b6ff4fdb25 agents/development-workflows-research-agent: expand allowedTools
Add Write, Edit, Agent, NotebookEdit, and mcp__* to the allowlist so
the research agent can author reports and delegate to subagents
without per-tool permission prompts.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:05 +05:00
Shayan Rais a1640f8bdf README: bump to v2.1.114, switch to 3rd-most-starred badge, sync CONCEPTS + workflow stats
- header badge: v2.1.112 (Apr 17) → v2.1.114 (Apr 18 8:22 PM PKT);
  rank badge 4th → 3rd (points to third-most-starred.svg)
- CONCEPTS table: add Ultrareview and Tasks rows; refresh No Flicker
  Mode (/tui fullscreen canonical), Auto Mode (--enable-auto-mode
  flag removed in v2.1.111), Scheduled Tasks (self-pacing via
  Monitor tool), Git Worktrees (EnterWorktree/ExitWorktree +
  isolation frontmatter)
- workflow table: star/count refresh (ECC 158k→160k, Superpowers
  156k→159k, gstack 74k→76k skills 46→37, GSD 54k→55k agents 31→33,
  omc 29k→30k, CE 14k→15k agents 49→50 commands 3→4 skills 51→44,
  OpenSpec commands 10→11)
- tips: rename /fewer-permission-prompts → /less-permission-prompts
  to match official skill name

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:24:01 +05:00
Shayan Rais 3861e8322e add 3rd-most-starred SVG badge for README header
Mirrors the fourth-most-starred SVG structure (128×20, green stroke,
🇵🇰 label) with the rank text bumped from "4th" to "3rd".

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 20:23:51 +05:00
Shayan Rais 53ed479bb9 added presentation 2026-04-18 16:28:04 +05:00
Shayan Rais 5b062383a8 agents/presentation-learning-journey: record rebuild protocol and data-loss prevention rule
Added mandatory learning: never run destructive git ops (checkout --, restore,
reset --hard) on uncommitted work. Added commit-per-milestone protocol, Write-tool
vs sed preference for large restructures, and full rebuild summary for the
2026-04-18 weather-reporter 37-slide deck.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 16:26:56 +05:00
Shayan Rais da3d99c6e7 learning-journey: complete weather-reporter redesign — 37 slides, 5-topic arc
Full deck rebuilt around the weather reporter as a single running example.
Opening arc (slides 1-5): no-correct-way framing → Boris GIF → vibe-vs-agentic
→ what-is-vibe-coding → good/bad prompts. Slide 6: Meet the Person TOC (5
vertical rows). Topic sections reordered: Agents (7-12) → Skills (13-18) →
Context (19-23) → CLAUDE.md (24-29) → Commands (30-32) → Workflow (33-36).
Closing slide 37: "Five concepts, one running example." LEVELS map heights
realigned to new arc order; journey ticks updated to match.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-18 16:26:51 +05:00
Shayan Rais 6fa7bcf4fa updated ques 2026-04-17 21:49:09 +05:00
Shayan Rais db0efc8142 updated 2026-04-17 21:39:53 +05:00
Shayan Rais 72f8aaff9e bump Claude Code badge to v2.1.112 (Apr 17, 2026 6:37 AM PKT)
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:38:47 +05:00
Shayan Rais 3a3a0e6623 link Boris Apr 16 tips into README — 6 tips across 3 sections
- Session Management (5 → 6): recaps for long-running sessions
- Workflows (4 → 6): /focus mode, adaptive-thinking effort level
- Workflows Advanced (6 → 9): auto mode, /fewer-permission-prompts, /go verify skill
- Tip total 76 → 82
- Boris workflow row and Article/Tweet list now reference the new file

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:37:20 +05:00
Shayan Rais c1c5cdaf27 add 6 Tips for Getting More Out of Opus 4.7 from Boris Cherny (Apr 16)
Six tips shared after dogfooding Opus 4.7: auto mode (no more permission
prompts), the /fewer-permission-prompts skill, recaps for long-running
sessions, focus mode, adaptive-thinking effort levels, and a /go skill
pattern for self-verification.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:37:12 +05:00
Shayan Rais cc1b5a0b49 rename thariq-16-apr-26 asset folder to thariq-26-4-16
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the session-management post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:29:08 +05:00
Shayan Rais 260d714740 rename thariq-17-mar-26 asset folder to thariq-26-3-17
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the skills-lessons post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:29:02 +05:00
Shayan Rais b5559c8c4a rename boris-30-mar-26 asset folder to boris-26-3-30
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the 15-hidden-features post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:28:56 +05:00
Shayan Rais 1979e196c9 rename boris-25-mar-26 asset folder to boris-26-3-25
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the squash-merging / PR-size post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:28:51 +05:00
Shayan Rais e9851f926b rename boris-10-mar-26 asset folder to boris-26-3-10
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the code-review / test-time-compute post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:28:44 +05:00
Shayan Rais 2d1e4586ba rename boris-12-feb-26 asset folder to boris-26-2-12
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the 12-customizations post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:28:38 +05:00
Shayan Rais 9c59bcf132 rename boris-1-feb-26 asset folder to boris-26-2-1
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the 10-tips post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:28:32 +05:00
Shayan Rais e2fd7bdc4a rename boris-3-jan-26 asset folder to boris-26-1-3
Adopt YY-M-D naming scheme (year-month-date, month as numeric) for
chronological sortability. Update image references in the 13-tips post.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:28:25 +05:00
Shayan Rais 3cbd840aaa add Context and Session Management tips sections from Thariq 16 April article
- split 10 context-management tips into Context (5) + Session Management (5)
- move /compact, /rewind, /rename tips out of Workflows into the new sections
- remove bold and inline-code formatting from tip content per style cleanup
- update TOC and section counts (total tips: 69 → 76)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-17 06:24:43 +05:00
Shayan Rais 2236e41c55 add fourth-most-starred SVG badge for README
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:54 +05:00
Shayan Rais 1e29779966 append development workflows changelog — star and count updates for 7 repos
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:42 +05:00
Shayan Rais 6d76b32cba add TIPS URL consistency rule to concepts verification checklist
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:41 +05:00
Shayan Rais e60b6b94eb append v2.1.110 changelog entry for concepts — fix stale /schedule URL in TIPS
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:40 +05:00
Shayan Rais 7efb351120 append v2.1.110 changelog entry for subagents report — no drift detected
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:39 +05:00
Shayan Rais e94a080386 append v2.1.110 changelog entry for skills report — no drift detected
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:38 +05:00