Commit Graph

135 Commits

Author SHA1 Message Date
Shayan Rais c00fe775c3 chore(workflow-concepts-agent): flag prose in Description column as drift
Updates the read-only research agent so it detects (rather than
generates) prose in the CONCEPTS Description column. Description
Accuracy check now explicitly flags sentence-style summaries; Return
Format and critical rule #8 require recommended Description values to
contain badges + links only.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 01:19:17 +05:00
Shayan Rais aa527f0013 chore(workflow-concepts): enforce badges-and-links-only Description column
Updates the executor command so future drift runs never reintroduce
prose into the CONCEPTS table Description column. Adds explicit
guidance in Phase 2 (Missing Concepts spec), Phase 3 (row template
now shows badge syntax), and as new critical rule #14.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 01:19:11 +05:00
Shayan Rais f50f4414f2 record presentation-claude-code Learnings from horse-teaser insertion
Agent self-update appending one Learnings bullet for the 2026-05-07 insert
of slide 9 "A horse. A model.": notes the stripped horse SVG composition,
the tightened viewBox (110 25 340 345 vs source's expanded -130 -50 780 450
that accommodated callouts), the etymology-line omission rationale, and a
regex-quirk for future integrity checks (CSS selector .slide[data-slide="1"]
matches naive data-slide="(\d+)" patterns — use <div[^>]+data-slide="(\d+)"
to scope to actual slide divs).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:22:19 +05:00
Shayan Rais 724c58b351 add /workflows:agent-collections slash command mirroring skill-collections workflow — researches AGENT COLLECTIONS repos in parallel, appends changelog, updates last-updated badge
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-05 21:31:00 +05:00
Shayan Rais 2c18c5d3be record etymology mirror and cross-deck consistency rule in GDG agent learnings
Adds a Learnings entry to the GDG presentation agent capturing
(1) the etymology line just added to slide 13, (2) the actual
data-slide value of the horse-harness analogy slide in this deck so
future cross-deck syncs can reference it, and (3) a forward-looking
rule for cross-deck mirroring: when an edit lands on the sister
best-practices deck and the same slide exists here (i.e. inherited
from the original fork), evaluate whether to mirror — generic content
mirrors cleanly, event-specific content does not. Also notes that
slides should be located by content, not by trusting "slide N", since
post-fork drift can shift numbering between the two decks.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 23:31:42 +05:00
Shayan Rais 76599cbee4 updated presentation 2026-04-30 23:25:04 +05:00
Shayan Rais 4fff87c29c record Models-are-stateless insert and sentinel double-increment fix in agent learnings
Adds a Learnings entry for the 2026-04-30 slide-10 insert: documents
the styled-HTML approach chosen (no PNG asset existed for this dialog),
the slide-12 caption-strip pattern reuse, and a postmortem for the
sentinel-replacement collision where pre-resolving ##S10## to "11" before
running the n=11..48 loop double-incremented old-slide-10 to "12". Adds
two forward-looking rules: (1) use distinct sentinel prefixes or
single-pass resolution when mixing pre-resolved and loop-resolved slides,
and (2) check raw file content for literal apostrophes vs HTML entities
when pattern-matching comment strings.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 22:25:46 +05:00
Shayan Rais 83d5583d33 record GDG slide-14 removal and cross-deck divergence in agent learnings
Appends a Learnings entry to the presentation-claude-gemini agent capturing
the 2026-04-30 removal of "How the Harness Reaches the World" from the GDG
deck and the deliberate-divergence framing — the slide lives on in the
forked claude-code-best-practice deck but is gone from the GDG historical
record because it was added post-event.

Future runs by this agent will know why the two decks differ on this slide
and won't try to "reconcile" them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:46 +05:00
Shayan Rais e5d3329412 add presentation-claude-code agent to delegation routing table
Updates the per-presentation delegation rule to route requests on the new
"Claude Code Best Practice" deck to the new presentation-claude-code agent.
Previously the table had only two decks (vibe-coding, claude-gemini); now
all three are listed with explicit path → agent mapping and an invocation
example.

Adds clarification that "the main presentation" or "the best-practice deck"
generally refers to the new claude-code agent.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:29 +05:00
Shayan Rais bb6d1083a8 add presentation-claude-code agent for the canonical best-practice deck
New per-deck agent owns presentation/claude-code-best-practice/index.html.
Mirrors the per-presentation pattern of presentation-claude-gemini and
presentation-vibe-coding — each deck has its own focused knowledge base
that self-evolves without cross-contaminating the others.

Seeded with structural facts about this deck specifically (no journey bar,
no hardcoded goToSlide(N) calls, simpler than the GDG fork) and a fresh
Learnings section starting at the 2026-04-30 fork date — GDG agent's 25+
historical entries deliberately not copied since most are tied to features
this deck doesn't have.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:23 +05:00
Shayan Rais 7fe7140e00 encode two-color sub-loop convention in /workflows:development-workflows command
Adds the fff3b0/ddf4ff color split to the Workflow column spec, asks
research agents to mark each step as (top) or (sub) in the structured
report, updates the Phase 3 execute step to map those markers to badge
colors, and makes the post-table legend mandatory via new Rule 11.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:27:01 +05:00
Shayan Rais 7f69a3e02f mandate HTML img with align="middle" and flat chains for Workflow column
Updates the /workflows:development-workflows command to require
HTML <img align="middle"> badges (so arrows align with badge
centers) and to forbid parenthetical sub-loops or English
qualifiers in the Workflow chain. Inner loop steps must be
listed as flat siblings.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:23:15 +05:00
Shayan Rais d0e72b910e drop Plan column from /workflows:development-workflows command
Removes the Plan-implementation research item from both agent prompts,
strips the PLAN line from the structured report format, and prunes the
Plan-link rules from Phase 0/2/3 and the Rules section. Column order
in the spec now matches the README: Name | ★ | Workflow | a | c | s.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:19:03 +05:00
Shayan Rais 2f21c03d87 update /workflows:development-workflows to populate new Workflow column and research 11 repos
Bumps repo count from 10 to 11 (adds mattpocock/skills to Agent 1's
batch), replaces "Uniqueness tags" research item with "Workflow"
canonical pipeline, and documents the shields.io badge encoding rules
(/ → %2F, - → --, _ → __, dots/colons verbatim) so the orchestrator
encodes plain-text agent output into ddf4ff badges consistently. Adds
mandatory Rule 11 forbidding synthesized pipelines — agents must trace
each repo's documented happy path.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:13:38 +05:00
Shayan Rais bb7d81c585 add /workflows:skill-collections command — research 5 skill-collection repos and refresh README table
Mirrors /workflows:development-workflows: 5 phases (read → launch → compare
→ changelog → execute), reuses development-workflows-research-agent, writes
to changelog/skill-collections/changelog.md. Single-agent batch (5 repos).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-28 18:16:56 +05:00
Shayan Rais f734255f60 rename presentation agent 2026-04-26 17:19:49 +05:00
Shayan Rais 9437efe323 updated 2026-04-26 17:13:50 +05:00
Shayan Rais eabba864a9 updated weather workflow 2026-04-26 16:55:11 +05:00
Shayan Rais 9f78707d51 workflow added 2026-04-24 21:40:27 +05:00
Shayan Rais deaaccdb61 context 2026-04-24 21:32:03 +05:00
Shayan Rais 10937f71cd skills added 2026-04-24 20:26:01 +05:00
Shayan Rais 45e31dc8da added tips 2026-04-24 19:41:17 +05:00
Shayan Rais 1c30bb165a updated cards 2026-04-24 17:57:01 +05:00
Shayan Rais dc73306e61 bottom cards added 2026-04-24 17:49:19 +05:00
Shayan Rais 5e039867a8 added 3 main pages 2026-04-24 16:58:43 +05:00
Shayan Rais a1168118d0 updated jargons 2026-04-24 12:32:54 +05:00
Shayan Rais 7174ae2ad3 updated presentation 2026-04-24 12:16:54 +05:00
Shayan Rais eefa980187 Merge pull request #65 from xiaolai/fix/nlpm-time-agent-name-collision
fix: rename root time-agent to time-agent-pkt to resolve name collision
2026-04-24 00:24:00 +05:00
Shayan Rais d1c2dcf4c4 Delete development-workflows-research-agent.md 2026-04-24 00:17:39 +05:00
Shayan Rais a4a347806b deleted 2 slides 2026-04-24 00:11:05 +05:00
claude[bot] 775d42bd40 fix: rename root time-agent to time-agent-pkt to resolve name collision
Two agent files both declared `name: time-agent` with different implementations:
- `.claude/agents/time-agent.md` (root): PKT, UTC+5 (Pakistan Standard Time)
- `agent-teams/.claude/agents/time-agent.md` (agent-teams): Dubai GST, UTC+4

When both scopes are active, Claude Code may invoke the wrong time-agent —
serving PKT time when a Dubai command expects GST, or vice versa.

Renamed the root agent's `name` from `time-agent` to `time-agent-pkt` so
the two agents are unambiguous. The agent-teams variant retains `name: time-agent`
since `agent-teams/.claude/commands/time-orchestrator.md` explicitly invokes it
by that name for Dubai time display.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-04-22 18:29:01 +00:00
Shayan Rais 421f8e1279 Update weather-orchestrator.md 2026-04-22 21:44:36 +05:00
Shayan Rais fe3434b42b presentation updated 2026-04-22 15:31:13 +05:00
Shayan Rais 41f50d781d added shayan introduction 2026-04-22 15:01:23 +05:00
Shayan Rais 08cf087a16 .claude/rules/presentation: switch Glob heading to paths: YAML frontmatter
The '# Glob: presentation/**' markdown heading was not parsed as scoping
metadata — Claude Code only reads YAML frontmatter with paths: for
path-specific rule loading. Without proper frontmatter, the file loaded
into every session instead of only presentation/** work. Now correctly
scoped via paths: ["presentation/**"] with H1 'Presentation Delegation'.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-20 00:07:52 +05:00
Shayan Rais 29e19dfbe0 .claude/rules/markdown-docs: switch Glob heading to paths: YAML frontmatter
The '# Glob: **/*.md' markdown heading was a cargo-cult label — Claude Code
only parses YAML frontmatter with paths: for path-scoping. Without it, the
file loaded unconditionally on every session. Now correctly scoped via
paths: ["**/*.md"] and H1 retitled to 'Markdown Docs' for human readers.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-20 00:07:46 +05:00
Shayan Rais d3b61467c4 .claude/agents/presentation-learning-journey: record scoped per-slide scroll override pattern
Documents the below-fold legend technique: min-height expansion, scroll affordance,
window.scrollTo(0,0) in showSlide(), and why no CSS ancestor changes are needed.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 12:58:00 +05:00
Shayan Rais 6b8d32a0f1 .claude/agents/presentation-learning-journey: record legend-footer pattern
Documents the color-coded definition table technique: shrink chip-cloud
container to free vertical space, add 2-col grid below with matching hex
term colors, 0.82rem rows, 9 items per column balancing color tiers.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 12:48:46 +05:00
Shayan Rais 82ac7fc9f3 .claude/agents/presentation-learning-journey: record hero-tier chip hierarchy pattern
Document inline styling approach for dominant/supporting chip tiers on word-cloud
slides: hero chips use 1.5-1.6rem / weight 800 / glow box-shadow; supporting chips
use 0.9-1.0rem / weight 600 / plain shadow. No new CSS classes needed.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-19 12:28:22 +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 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 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 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 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 db0efc8142 updated 2026-04-17 21:39:53 +05:00
Shayan Rais 9c1597c009 fix indentation in settings.json permissions block
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:24 +05:00
Shayan Rais 65fe4f0cf8 disable PreToolUse, Notification, and InstructionsLoaded hooks in config
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:24 +05:00
Shayan Rais 37fa0bac05 update hook property names and add PreCompact blocking output to hooks README
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:23 +05:00
Shayan Rais 724b02356b add weather data entries for 2026-04-16 (23.8°C Dubai)
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 23:45:20 +05:00