From d873192d3650d6c992ebaa2a9fff57a4ae10d794 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 8 Apr 2026 18:56:51 +0000 Subject: [PATCH 1/4] feat: add spatie/laravel-markdown-response research note Agent-Logs-Url: https://github.com/ChrisThompsonTLDR/agentic-programming/sessions/c322f07a-c1f3-40a9-a266-9988b51730b7 Co-authored-by: ChrisThompsonTLDR <348801+ChrisThompsonTLDR@users.noreply.github.com> --- .../spatie__laravel-markdown-response.md | 73 +++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 .steering/laravel-packages/spatie__laravel-markdown-response.md diff --git a/.steering/laravel-packages/spatie__laravel-markdown-response.md b/.steering/laravel-packages/spatie__laravel-markdown-response.md new file mode 100644 index 0000000..cbe432b --- /dev/null +++ b/.steering/laravel-packages/spatie__laravel-markdown-response.md @@ -0,0 +1,73 @@ +--- +title: laravel-markdown-response +org: spatie +package: laravel-markdown-response +github_url: https://github.com/spatie/laravel-markdown-response +docs_url: https://spatie.be/docs/laravel-markdown-response/v1/introduction +composer_require: composer require spatie/laravel-markdown-response +author: Freek Van der Herten +announce_date: 2025-04-07 +latest_release: +release_date: +laravel_news_url: https://laravel-news.com/serve-markdown-versions-of-your-laravel-pages-to-ai-agents +downloads_30d: +stars: +tags: [laravel, packages, markdown, ai-agents, llm, response, content-negotiation, llms-txt] +--- + +# laravel-markdown-response + +**A Laravel package that lets you serve Markdown versions of your web pages alongside standard HTML responses, enabling AI agents and LLM-powered tools to consume your content directly.** + +## Key Features +- Register routes that automatically have a `.md` Markdown counterpart +- Return `MarkdownResponse` instead of a standard view response to serve structured Markdown +- Supports content negotiation via `Accept` header and `.md` URL suffix +- Enables AI crawlers and agents to read your pages as clean Markdown +- Integrates seamlessly with existing Laravel route definitions +- Pair with `llms.txt` conventions for full AI-agent discoverability + +## Installation + +```bash +composer require spatie/laravel-markdown-response +``` + +## Usage + +Return a `MarkdownResponse` from any controller action: + +```php +use Spatie\LaravelMarkdownResponse\MarkdownResponse; + +class DocsController extends Controller +{ + public function show(string $slug): MarkdownResponse + { + $content = // fetch your Markdown content... + + return new MarkdownResponse($content); + } +} +``` + +Or register a route with an automatic Markdown counterpart: + +```php +use Spatie\LaravelMarkdownResponse\MarkdownResponse; + +Route::get('/docs/{slug}', function (string $slug) { + return new MarkdownResponse( + view: 'docs.show', + data: ['slug' => $slug], + ); +})->withMarkdownRoute(); +``` + +Visiting `/docs/introduction.md` (or sending `Accept: text/markdown`) will return the Markdown version; `/docs/introduction` returns the normal HTML view. + +## Resources +- [GitHub](https://github.com/spatie/laravel-markdown-response) +- [Docs](https://spatie.be/docs/laravel-markdown-response/v1/introduction) +- [Laravel News](https://laravel-news.com/serve-markdown-versions-of-your-laravel-pages-to-ai-agents) +- [[Laravel Packages]] From 9035844f4c7e0bbba8453beee722d05b2bc53738 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 8 Apr 2026 19:00:23 +0000 Subject: [PATCH 2/4] fix: populate missing fields and add browser tool to laravel-package agent Agent-Logs-Url: https://github.com/ChrisThompsonTLDR/agentic-programming/sessions/f670893c-3186-4b04-ab28-336ca95cc1d3 Co-authored-by: ChrisThompsonTLDR <348801+ChrisThompsonTLDR@users.noreply.github.com> --- .github/agents/laravel-package.agent.md | 2 +- .../laravel-packages/spatie__laravel-markdown-response.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/.github/agents/laravel-package.agent.md b/.github/agents/laravel-package.agent.md index de33d49..9abe3e4 100644 --- a/.github/agents/laravel-package.agent.md +++ b/.github/agents/laravel-package.agent.md @@ -1,7 +1,7 @@ --- name: laravel-package description: "Researches Laravel packages and generates Obsidian notes. Usage: /laravel-package " -tools: ["read", "search", "edit"] +tools: ["read", "search", "edit", "browser"] mcp-servers: deepwiki: type: sse diff --git a/.steering/laravel-packages/spatie__laravel-markdown-response.md b/.steering/laravel-packages/spatie__laravel-markdown-response.md index cbe432b..14dd68b 100644 --- a/.steering/laravel-packages/spatie__laravel-markdown-response.md +++ b/.steering/laravel-packages/spatie__laravel-markdown-response.md @@ -7,12 +7,12 @@ docs_url: https://spatie.be/docs/laravel-markdown-response/v1/introduction composer_require: composer require spatie/laravel-markdown-response author: Freek Van der Herten announce_date: 2025-04-07 -latest_release: -release_date: +latest_release: v1.1.0 (2026-02-22) +release_date: 2026-02-22 laravel_news_url: https://laravel-news.com/serve-markdown-versions-of-your-laravel-pages-to-ai-agents downloads_30d: -stars: -tags: [laravel, packages, markdown, ai-agents, llm, response, content-negotiation, llms-txt] +stars: 67 +tags: [laravel, packages, markdown, ai, ai-agents, llm, response, content-negotiation, llms-txt] --- # laravel-markdown-response From a2318ae7d1f2f6ad02a7af536c2ad353c61233a4 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 8 Apr 2026 20:14:32 +0000 Subject: [PATCH 3/4] feat: add browser tool to mcp-research and skill-research agents Agent-Logs-Url: https://github.com/ChrisThompsonTLDR/agentic-programming/sessions/2bf7e699-0391-460c-854f-c64b0e2ef1f3 Co-authored-by: ChrisThompsonTLDR <348801+ChrisThompsonTLDR@users.noreply.github.com> --- .github/agents/mcp-research.agent.md | 2 +- .github/agents/skill-research.agent.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/agents/mcp-research.agent.md b/.github/agents/mcp-research.agent.md index 0b136c9..e19e3c4 100644 --- a/.github/agents/mcp-research.agent.md +++ b/.github/agents/mcp-research.agent.md @@ -1,7 +1,7 @@ --- name: mcp-research description: "Researches a Model Context Protocol (MCP) server from a URL and generates a structured research note. Usage: /mcp-research " -tools: ["read", "search", "edit"] +tools: ["read", "search", "edit", "browser"] mcp-servers: deepwiki: type: sse diff --git a/.github/agents/skill-research.agent.md b/.github/agents/skill-research.agent.md index dbfccda..3806d7b 100644 --- a/.github/agents/skill-research.agent.md +++ b/.github/agents/skill-research.agent.md @@ -1,7 +1,7 @@ --- name: skill-research description: "Researches a GitHub Copilot skill from a GitHub URL and generates a structured research note. Usage: /skill-research " -tools: ["read", "search", "edit"] +tools: ["read", "search", "edit", "browser"] mcp-servers: deepwiki: type: sse From cd7542339c8ca67ef06c8d764e36b79970131cab Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 8 Apr 2026 20:18:18 +0000 Subject: [PATCH 4/4] feat: add context7 to mcp-research and skill-research agents Agent-Logs-Url: https://github.com/ChrisThompsonTLDR/agentic-programming/sessions/c9d8e05c-0054-4193-8546-c60544648728 Co-authored-by: ChrisThompsonTLDR <348801+ChrisThompsonTLDR@users.noreply.github.com> --- .github/agents/mcp-research.agent.md | 6 ++++++ .github/agents/skill-research.agent.md | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/.github/agents/mcp-research.agent.md b/.github/agents/mcp-research.agent.md index e19e3c4..7f22b29 100644 --- a/.github/agents/mcp-research.agent.md +++ b/.github/agents/mcp-research.agent.md @@ -9,6 +9,12 @@ mcp-servers: tools: ["*"] headers: Authorization: "Bearer $DEEPWIKI_KEY" + context7: + command: npx + args: ["@context7/mcp-server"] + tools: ["*"] + env: + CONTEXT7_API_KEY: $CONTEXT7_KEY github: type: sse url: https://mcp.github.com/sse diff --git a/.github/agents/skill-research.agent.md b/.github/agents/skill-research.agent.md index 3806d7b..6f1bc16 100644 --- a/.github/agents/skill-research.agent.md +++ b/.github/agents/skill-research.agent.md @@ -9,6 +9,12 @@ mcp-servers: tools: ["*"] headers: Authorization: "Bearer $DEEPWIKI_KEY" + context7: + command: npx + args: ["@context7/mcp-server"] + tools: ["*"] + env: + CONTEXT7_API_KEY: $CONTEXT7_KEY github: type: sse url: https://mcp.github.com/sse