Updated readmes with consistent template

Author: D-K-P

changelog-generator/README.md

@@ -1,47 +1,19 @@
-# Changelog Generator using Claude Agent SDK and Trigger.dev
+# Changelog generator using theClaude Agent SDK and Trigger.dev
 
-Generate changelogs from GitHub commits using AI with a two-phase approach: scan commits first, then selectively fetch diffs for unclear changes.
-
-## Demo video
-
-<video src="https://content.trigger.dev/claude-changelog-generator.mp4" controls autoplay loop muted width="100%"></video>
+An AI agent that explores GitHub commits, investigates unclear changes by fetching diffs on demand, and generates developer-friendly changelogs. Built with the Claude Agent SDK and Trigger.dev.
 
 ## Tech Stack
 
 - **[Next.js](https://nextjs.org)** – Frontend framework using App Router
 - **[Claude Agent SDK](https://github.com/anthropics/claude-agent-sdk)** – Anthropic's agent SDK for building AI agents with custom tools
-- **[Trigger.dev](https://trigger.dev)** – Background task orchestration with real-time streaming to the frontend
-- **[Octokit](https://github.com/octokit/octokit.js)** – GitHub API client
+- **[Trigger.dev](https://trigger.dev)** – Background task orchestration with real-time streaming to the frontend, observability, and deployment.
+- **[Octokit](https://github.com/octokit/octokit.js)** – GitHub API client for fetching commits and diffs.
 
-## Features
+## Demo
 
-- **Two-phase intelligent analysis**:
-  1. Claude first lists all commits in the date range
-  2. For unclear commits ("fix bug", "update"), Claude requests the actual diff
-  3. Generates grouped changelog with full context
-- **Custom MCP tools** – Claude can call `list_commits` and `get_commit_diff` on demand
-- **Private repo support** – Optional GitHub token for private repositories
-- **Real-time streaming** – Watch the changelog generate live
-
-## How It Works
-
-```
-User enters repo URL + date range
-    ↓
-API triggers generate-changelog task
-    ↓
-Claude Agent SDK with custom GitHub tools:
-  - list_commits: fetches commit messages via GitHub API
-  - get_commit_diff: fetches diff for specific commit SHA
-    ↓
-Claude explores commits, requests diffs as needed
-    ↓
-Generates grouped changelog
-    ↓
-Streams to frontend via Trigger.dev Realtime
-```
-
-## Setup
+<video src="https://content.trigger.dev/claude-changelog-generator.mp4" controls autoplay loop muted width="100%"></video>
+
+## Running the project locally
 
 1. **Install dependencies**
 
@@ -55,8 +27,6 @@ Streams to frontend via Trigger.dev Realtime
    cp .env.example .env
    ```
 
-   Fill in:
-
    - `TRIGGER_SECRET_KEY` – From [Trigger.dev dashboard](https://cloud.trigger.dev/)
    - `TRIGGER_PROJECT_REF` – Your project ref (starts with `proj_`)
    - `ANTHROPIC_API_KEY` – From [Anthropic Console](https://console.anthropic.com/)
@@ -68,29 +38,24 @@ Streams to frontend via Trigger.dev Realtime
    # Terminal 1: Next.js
    npm run dev
 
-   # Terminal 2: Trigger.dev CLI
+   # Terminal 2: Trigger.dev
    npx trigger.dev@latest dev
    ```
 
-4. Open [http://localhost:3000](http://localhost:3000)
+4. Open [http://localhost:3000](http://localhost:3000) in your browser to see the demo
+
+## Features
+
+- **Two-phase analysis** – Lists all commits first, then selectively fetches diffs only for ambiguous ones to minimize token usage
+- **Custom MCP tools** – `list_commits` and `get_commit_diff` called autonomously by Claude
+- **Real-time streaming** – Changelog streams to the frontend as it's generated via Trigger.dev Realtime
+- **Live observability** – Agent phase, turn count, and tool calls broadcast via run metadata
+- **Markdown rendering** – Streamed output formatted with [Streamdown](https://github.com/vercel/streamdown) and Shiki syntax highlighting
+- **Private repo support** – Optional GitHub token for private repositories
 
 ## Relevant Files
 
-- [trigger/generate-changelog.ts](trigger/generate-changelog.ts) – Main task with custom MCP tools for GitHub
-- [trigger/changelog-stream.ts](trigger/changelog-stream.ts) – Stream definition for real-time output
+- [trigger/generate-changelog.ts](trigger/generate-changelog.ts) – Main task with MCP tools
+- [trigger/changelog-stream.ts](trigger/changelog-stream.ts) – Stream definition
 - [app/api/generate-changelog/route.ts](app/api/generate-changelog/route.ts) – API endpoint
 - [app/response/[runId]/page.tsx](app/response/[runId]/page.tsx) – Streaming display page
-
-## Custom Tools
-
-The task defines two custom MCP tools that Claude can use:
-
-```typescript
-// List commits with messages (lightweight)
-list_commits({ since: "2024-01-01", until: "2024-02-01" });
-
-// Get full diff for a specific commit (on-demand)
-get_commit_diff({ sha: "abc1234" });
-```
-
-This two-phase approach minimizes token usage while giving Claude full context when needed.

claude-agent-github-wiki/README.md

@@ -1,86 +1,59 @@
 # GitHub repository analyzer agent using Claude and Trigger.dev
 
-This demo shows how to build a simple AI-powered repository analyzer that lets you ask questions about any public GitHub repository, using [Trigger.dev](https://trigger.dev/) for workflow orchestration, streaming, and showing progress on the frontend and [Anthropic's Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview) for the agentic loop.
-
-## Demo video
-
-<video src="https://content.trigger.dev/Claude%20GitHub%20Wiki-example.mp4" controls autoplay loop muted width="100%"></video>
+Ask questions about any public GitHub repository and get AI-powered analysis using the Claude Agent SDK for agentic exploration and Trigger.dev for real-time streaming to the frontend.
 
 ## Tech stack
 
-- [**Next.js**](https://nextjs.org/) – Frontend framework using the App Router
-- [**Claude Agent SDK**](https://platform.claude.com/docs/en/agent-sdk/overview) – Anthropic's SDK for building AI agents; provides an agentic loop with shell, file, and search tools
-- [**Trigger.dev**](https://trigger.dev/) – runs the agent in a long-running background task with real-time streaming to the frontend
+- **[Next.js](https://nextjs.org/)** – React framework with App Router for the frontend
+- **[Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview)** – Anthropic's SDK for building AI agents with file system and search tools
+- **[Trigger.dev](https://trigger.dev/)** – Background task orchestration with real-time streaming to the frontend, observability, and deployment
 
-## Features
+## Demo
 
-- **Ask anything about any public repo** – Architecture, security vulnerabilities, API endpoints, testing strategies, etc.
-- **Claude Agent SDK exploration** – Claude explores the codebase and provide detailed answers
-- **Cancel anytime** – Abort long-running Trigger.dev task with cleanup
-- **Trigger.dev Realtime streaming** – Watch Claude's analysis stream in as it's generated
-- **Progress tracking using Trigger.dev Realtime** – See clone status, analysis progress, and repo size
-
-## Setup & running locally
-
-1. **Clone the repository**
+<video src="https://content.trigger.dev/Claude%20GitHub%20Wiki-example.mp4" controls autoplay loop muted width="100%"></video>
 
-   ```bash
-   git clone <repository-url>
-   cd claude-agent-github-wiki
-   ```
+## Running the project locally
 
-2. **Install dependencies**
+1. **Install dependencies**
 
    ```bash
    npm install
    ```
 
-3. **Copy environment variables and configure**
+2. **Configure environment variables**
 
    ```bash
    cp .env.example .env
    ```
 
-   Fill in the required environment variables:
-
-   - `TRIGGER_SECRET_KEY` – Get this from the [Trigger.dev dashboard](https://cloud.trigger.dev/)
-   - `TRIGGER_PROJECT_REF` – Your Trigger.dev project ref (starts with `proj_`)
-   - `ANTHROPIC_API_KEY` – Get this from the [Anthropic Console](https://console.anthropic.com/)
+   - `TRIGGER_SECRET_KEY` – From [Trigger.dev dashboard](https://cloud.trigger.dev/)
+   - `TRIGGER_PROJECT_REF` – Your project ref (starts with `proj_`)
+   - `ANTHROPIC_API_KEY` – From [Anthropic Console](https://console.anthropic.com/)
 
-4. **Start the development servers**
+3. **Start development servers**
 
    ```bash
-   # Terminal 1: Start Next.js dev server
+   # Terminal 1: Next.js
    npm run dev
 
-   # Terminal 2: Start Trigger.dev CLI
+   # Terminal 2: Trigger.dev
    npx trigger.dev@latest dev
    ```
 
-   Open [http://localhost:3000](http://localhost:3000)
-
-## How it works
-
-Trigger.dev orchestrates the repository analysis through a single long-running task:
+4. Open [http://localhost:3000](http://localhost:3000) in your browser
 
-1. **`analyzeRepo`** – Main task that:
-   - Clones the repository to a temp directory (shallow clone for speed)
-   - Spawns a Claude agent with file system tools
-   - Streams Claude's response to the frontend in real-time via Trigger.dev's Realtime Streams
-   - Cleans up the temp directory on completion or error
-
-## Relevant code
+## Features
 
-- **Main analysis task** – Clones repo, runs Claude agent, streams response ([`trigger/analyze-repo.ts`](trigger/analyze-repo.ts))
-- **Stream definition** – Typed stream for real-time text responses ([`trigger/agent-stream.ts`](trigger/agent-stream.ts))
-- **API endpoint** – Triggers the task and returns a public access token ([`app/api/analyze-repo/route.ts`](app/api/analyze-repo/route.ts))
-- **Response page** – Real-time streaming display with progress ([`app/response/[runId]/page.tsx`](app/response/[runId]/page.tsx))
-- **Landing page** – Repository URL input with example repos ([`app/page.tsx`](app/page.tsx))
-- **Trigger.dev config** – Project settings with external SDK bundle ([`trigger.config.ts`](trigger.config.ts))
+- **Ask anything about any public repo** – Architecture, security vulnerabilities, API endpoints, testing strategies, etc.
+- **Claude Agent SDK exploration** – Claude explores the codebase using Grep and Read tools to provide detailed answers
+- **Cancel anytime** – Abort long-running tasks with proper cleanup
+- **Trigger.dev Realtime streaming** – Watch Claude's analysis stream in as it's generated
+- **Progress tracking** – See clone status, analysis progress, and repo size via Trigger.dev metadata
 
-## Learn more
+## Relevant files
 
-- [**Trigger.dev Realtime Streams**](https://trigger.dev/docs/realtime/streams) – Stream data from tasks to your frontend
-- [**Trigger.dev React Hooks**](https://trigger.dev/docs/realtime/react-hooks/overview) – `useRealtimeStream` for consuming streams
-- [**Claude Agent SDK**](https://platform.claude.com/docs/en/agent-sdk/overview) – Run Claude with agentic tool usage
-- [**Trigger.dev schemaTask**](https://trigger.dev/docs/tasks/schemaTask) – Type-safe task payloads with Zod
+- [`trigger/analyze-repo.ts`](trigger/analyze-repo.ts) – Main task that clones repo, runs Claude agent, and streams response
+- [`trigger/agent-stream.ts`](trigger/agent-stream.ts) – Typed stream definition for real-time text responses
+- [`app/api/analyze-repo/route.ts`](app/api/analyze-repo/route.ts) – API endpoint that triggers the task and returns a public access token
+- [`app/response/[runId]/page.tsx`](app/response/[runId]/page.tsx) – Real-time streaming display with progress
+- [`trigger.config.ts`](trigger.config.ts) – Project config with external SDK bundle