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/.github/agents/mcp-research.agent.md b/.github/agents/mcp-research.agent.md index 0b136c9..7f22b29 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 @@ -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 dbfccda..6f1bc16 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 @@ -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/.steering/laravel-packages/spatie__laravel-markdown-response.md b/.steering/laravel-packages/spatie__laravel-markdown-response.md new file mode 100644 index 0000000..14dd68b --- /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: 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: 67 +tags: [laravel, packages, markdown, ai, 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]]