feat: add AI agent readiness kit and machine-readable endpoints

public/.well-known/ai-plugin.json

@@ -1,18 +1,18 @@
 {
   "schema_version": "v1",
-  "name_for_human": "TODO Project name (AOSSIE Webpage Starter)",
+  "name_for_human": "TODO Project Name (AOSSIE Webpage Starter)",
   "name_for_model": "todo_project_name (aossie_webpage_starter)",
-  "description_for_human": "TODO Project description (AOSSIE Webpage Starter)",
+  "description_for_human": "TODO Project Description (AOSSIE Webpage Starter)",
   "description_for_model": "Retrieve settings, theme configuration, and supported locales from the TODO: Project (AOSSIE webpage starter).",
   "auth": {
     "type": "none"
   },
   "api": {
     "type": "openapi",
-    "url": "https://TODO:project.aossie.org/openapi.yaml",
+    "url": "https://TODO:project.aossie.org/openapi.json",
     "is_user_authenticated": false
   },
   "logo_url": "https://TODO:project.aossie.org/brand/icons/aossie_logo.svg",
   "contact_email": "admin@aossie.org",
   "legal_info_url": "https://TODO:project.aossie.org/legal"
-}
+}

public/.well-known/mcp.json

@@ -0,0 +1,15 @@
+{
+  "schema_version": "v1",
+  "name": "TODO: Project Name MCP Server (AOSSIE Webpage Starter)",
+  "description": "Model Context Protocol server for TODO: Project (AOSSIE webpage starter)",
+  "version": "1.0.0",
+  "transport": {
+    "type": "sse",
+    "url": "https://TODO:project.aossie.org/api/mcp"
+  },
+  "capabilities": {
+    "tools": true,
+    "resources": true,
+    "prompts": true
+  }
+}

public/api/index.html

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>TODO: Project Name API</title>
+  <meta name="description" content="Machine-readable API for TODO: Project (AOSSIE Webpage Starter)." />
+</head>
+<body>
+  <h1>TODO: Project Name API</h1>
+  <p>Version: 1.0.0</p>
+  <p>Machine-readable API endpoints and documentation for TODO: Project (AOSSIE Webpage Starter).</p>
+
+  <h2>Endpoints</h2>
+  <ul>
+    <li><a href="/api/info.json">/api/info.json</a> &mdash; Project metadata (JSON)</li>
+    <li><a href="/openapi.json">/openapi.json</a> &mdash; OpenAPI 3.0.1 specification</li>
+    <li><a href="/llms.txt">/llms.txt</a> &mdash; LLMs.txt for AI agents</li>
+    <li><a href="/.well-known/ai-plugin.json">/.well-known/ai-plugin.json</a> &mdash; AI Plugin manifest</li>
+    <li><a href="/.well-known/mcp.json">/.well-known/mcp.json</a> &mdash; MCP server manifest</li>
+  </ul>
+
+  <h2>Example Response</h2>
+  <pre><code>GET /api/info.json
+
+{
+  "name": "TODO: Project Name (AOSSIE Webpage Starter)",
+  "version": "1.0.0",
+  "description": "TODO: Project Description (AOSSIE Webpage Starter)",
+  "features": [...]
+}</code></pre>
+</body>
+</html>

public/api/info.json

@@ -0,0 +1,20 @@
+{
+  "name": "TODO: Project Name (AOSSIE Webpage Starter)",
+  "version": "1.0.0",
+  "description": "TODO: Project Description (AOSSIE Webpage Starter)",
+  "repository": "https://github.com/AOSSIE-Org/Template-Repo-NextJS",
+  "documentation": "https://TODO:project.aossie.org/api/",
+  "features": [
+    "Next.js 16 (App Router)",
+    "React 19",
+    "Tailwind CSS v4",
+    "Internationalization (next-intl)",
+    "AI Agent Readiness (LLMs.txt, OpenAPI, MCP)"
+  ],
+  "links": {
+    "home": "https://TODO:project.aossie.org/",
+    "docs": "https://TODO:project.aossie.org/api/",
+    "openapi": "https://TODO:project.aossie.org/openapi.json",
+    "llms": "https://TODO:project.aossie.org/llms.txt"
+  }
+}

public/api/v1/index.html

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>TODO: Project Name API v1</title>
+  <meta name="description" content="API v1 documentation for TODO: Project (AOSSIE Webpage Starter)." />
+</head>
+<body>
+  <h1>TODO: Project Name API v1</h1>
+  <p>Version: 1.0.0</p>
+  <p>API v1 endpoints and specifications for TODO: Project (AOSSIE Webpage Starter).</p>
+
+  <h2>Endpoints</h2>
+  <ul>
+    <li><a href="/api/info.json">/api/info.json</a> &mdash; Project metadata (JSON)</li>
+    <li><a href="/openapi.json">/openapi.json</a> &mdash; OpenAPI 3.0.1 specification</li>
+    <li><a href="/llms.txt">/llms.txt</a> &mdash; LLMs.txt for AI agents</li>
+  </ul>
+</body>
+</html>

public/llms.txt

@@ -36,4 +36,12 @@ This repository is a high-performance webpage built on **Next.js 16 (App Router)
 
 ## 📦 Build Commands
 - **Build:** `npm run build`
-- **Develop:** `npm run dev`
+- **Develop:** `npm run dev`
+---
+
+## 🤖 AI & Machine-Readable Interfaces
+- [API Reference](/api/): Available API endpoints
+- [OpenAPI Spec](/openapi.json): Machine-readable OpenAPI 3.0.1 specification
+- [AI Plugin Manifest](/.well-known/ai-plugin.json): OpenAI plugin manifest
+- [MCP Manifest](/.well-known/mcp.json): Model Context Protocol server configuration
+- [Project Info](/api/info.json): Structured project metadata endpoint

public/openapi.json

@@ -0,0 +1,58 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "TODO: Project Name API (AOSSIE Webpage Starter)",
+    "version": "1.0.0",
+    "description": "API specification for TODO: Project (AOSSIE webpage starter). Replace this description with your project's purpose."
+  },
+  "servers": [
+    {
+      "url": "https://TODO:project.aossie.org",
+      "description": "Production server (Replace with your actual production domain)"
+    }
+  ],
+  "paths": {
+    "/api/info.json": {
+      "get": {
+        "summary": "Get project metadata and ecosystem information",
+        "description": "Returns structured JSON with project metadata, version, features, and links.",
+        "responses": {
+          "200": {
+            "description": "Project information",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProjectInfo"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "ProjectInfo": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "example": "TODO: Project Name (AOSSIE Webpage Starter)"
+          },
+          "version": {
+            "type": "string",
+            "example": "1.0.0"
+          },
+          "description": {
+            "type": "string",
+            "example": "TODO: Project Description (AOSSIE Webpage Starter)"
+          },
+          "links": {
+            "type": "object"
+          }
+        }
+      }
+    }
+  }
+}

public/robots.txt

@@ -1,8 +1,25 @@
 User-agent: *
 Allow: /
-Disallow: /api/
 Disallow: /_vercel/
 
+# AI crawlers - explicitly allowed
+User-agent: GPTBot
+Allow: /
+
+User-agent: ClaudeBot
+Allow: /
+
+User-agent: anthropic-ai
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+User-agent: CCBot
+Allow: /
+
+User-agent: Google-Extended
+Allow: /
 
 # Replace the placeholder domain TODO:'project.aossie.org' below with your actual project production domain.
 Sitemap: https://TODO:project.aossie.org/sitemap.xml

src/app/[locale]/layout.tsx

@@ -62,12 +62,49 @@ export default async function RootLayout({
   // Provide messages to Client Components directly via messagesMap
   const messages = messagesMap[locale] || defaultMessages;
 
+  // Schema.org structured data for AI agent discoverability
+  // Replace fallback domain 'https://TODO:project.aossie.org' with your target production domain.
+  const rawSiteUrl = process.env.NEXT_PUBLIC_SITE_URL || "https://TODO:project.aossie.org";
+  const siteUrl = rawSiteUrl.replace(/\/$/, "");
+
+  const jsonLd = {
+    "@context": "https://schema.org",
+    "@graph": [
+      {
+        "@type": "WebSite",
+        "@id": `${siteUrl}/#website`,
+        "url": `${siteUrl}/`,
+        "name": "TODO: Project Name (AOSSIE Webpage Starter)",
+        "description": "TODO: Project Description (AOSSIE Webpage Starter)",
+      },
+      {
+        "@type": "SoftwareApplication",
+        "@id": `${siteUrl}/#application`,
+        "name": "TODO: Project Name (AOSSIE Webpage Starter)",
+        "applicationCategory": "WebApplication",
+        "operatingSystem": "Web",
+        "url": `${siteUrl}/`,
+        "author": {
+          "@type": "Organization",
+          "name": "AOSSIE",
+          "url": "https://aossie.org",
+        },
+      },
+    ],
+  };
+
   return (
     <html
       lang={locale}
       className={`${inter.variable} ${devanagari.variable} h-full antialiased`}
       suppressHydrationWarning
     >
+      <head>
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+        />
+      </head>
       <body className="min-h-full flex flex-col bg-background text-foreground" suppressHydrationWarning>
         <NextIntlClientProvider locale={locale} messages={messages} timeZone="UTC">
           <ThemeProvider>
@@ -80,5 +117,3 @@ export default async function RootLayout({
     </html>
   );
 }
-
-

src/app/api/info/route.ts

@@ -0,0 +1,28 @@
+import { NextResponse } from "next/server";
+
+export const dynamic = "force-static";
+
+export async function GET() {
+  const rawSiteUrl = process.env.NEXT_PUBLIC_SITE_URL || "https://TODO:project.aossie.org";
+  const siteUrl = rawSiteUrl.replace(/\/$/, "");
+
+  return NextResponse.json({
+    name: "TODO: Project Name (AOSSIE Webpage Starter)",
+    version: "1.0.0",
+    description: "TODO: Project Description (AOSSIE Webpage Starter)",
+    repository: "https://github.com/AOSSIE-Org/Template-Repo-NextJS",
+    features: [
+      "Next.js 16 (App Router)",
+      "React 19",
+      "Tailwind CSS v4",
+      "Internationalization (next-intl)",
+      "AI Agent Readiness (LLMs.txt, OpenAPI, MCP)"
+    ],
+    links: {
+      home: `${siteUrl}/`,
+      docs: `${siteUrl}/api/`,
+      openapi: `${siteUrl}/openapi.json`,
+      llms: `${siteUrl}/llms.txt`
+    }
+  });
+}