Improve agent recovery and developer discovery

Author: Hilo-Hilo

index.html

@@ -6,9 +6,11 @@
     <title>Computational Biology at Berkeley</title>
     <meta name="description" content="A UC Berkeley student organization connecting biology, computer science, and healthcare through education, research, projects, and community." />
     <meta name="author" content="Computational Biology at Berkeley" />
+    <meta name="application-name" content="Computational Biology at Berkeley" />
     <meta name="theme-color" content="#FFFFFF" />
     <link rel="canonical" href="https://compbioatberkeley.github.io/" />
     <link rel="describedby" href="/llms.txt" type="text/markdown" />
+    <link rel="help" href="/developers.md" type="text/markdown" />
     <link
       rel="icon"
       type="image/svg+xml"
@@ -82,6 +84,7 @@
     </script>
 
     <meta property="og:title" content="Computational Biology at Berkeley" />
+    <meta property="og:site_name" content="Computational Biology at Berkeley" />
     <meta property="og:description" content="A UC Berkeley student organization connecting biology, computer science, and healthcare through education, research, projects, and community." />
     <meta property="og:type" content="website" />
     <meta property="og:url" content="https://compbioatberkeley.github.io/" />

public/404.html

@@ -10,6 +10,7 @@
     />
     <meta name="robots" content="noindex, nofollow" />
     <link rel="describedby" href="/llms.txt" type="text/markdown" />
+    <link rel="alternate" href="/404.md" type="text/markdown" title="Markdown recovery" />
     <script>
       (function () {
         var projectName = "compbioatberkeley.github.io";
@@ -72,6 +73,18 @@
         line-height: 1.65;
       }
 
+      .agent-recovery {
+        margin: 1.5rem 0 0;
+        overflow-x: auto;
+        border: 1px solid rgba(24, 34, 39, 0.18);
+        border-radius: 0.25rem;
+        padding: 1rem;
+        font: inherit;
+        font-size: 0.8rem;
+        line-height: 1.6;
+        white-space: pre-wrap;
+      }
+
       nav {
         display: flex;
         flex-wrap: wrap;
@@ -99,6 +112,10 @@
         a {
           color: #7dd3fc;
         }
+
+        .agent-recovery {
+          border-color: rgba(238, 241, 237, 0.2);
+        }
       }
     </style>
   </head>
@@ -110,11 +127,18 @@ <h1>Page not found</h1>
         The requested page does not exist or may have moved. Use the site map for all public pages,
         or use the agent guide for a concise Markdown overview of this site.
       </p>
+      <pre class="agent-recovery" aria-label="Markdown recovery"># Page not found
+
+- Sitemap: https://compbioatberkeley.github.io/sitemap.xml
+- Agent guide: https://compbioatberkeley.github.io/llms.txt
+- Developer resources: https://compbioatberkeley.github.io/developers.md</pre>
       <nav aria-label="Recovery links">
         <a href="/">Home</a>
         <a href="/sitemap.xml">Sitemap</a>
         <a href="/llms.txt">Agent guide (Markdown)</a>
         <a href="/agent-instructions.md">Agent instructions</a>
+        <a href="/404.md">404 recovery (Markdown)</a>
+        <a href="/developers/">Developer resources</a>
         <a href="/contact/">Contact</a>
       </nav>
     </main>

public/404.md

@@ -0,0 +1,11 @@
+# Page not found
+
+The requested Computational Biology at Berkeley page does not exist or may have moved.
+
+- [Browse the sitemap](https://compbioatberkeley.github.io/sitemap.xml)
+- [Read the concise agent guide](https://compbioatberkeley.github.io/llms.txt)
+- [Read the agent instructions](https://compbioatberkeley.github.io/agent-instructions.md)
+- [Open the developer resource index](https://compbioatberkeley.github.io/developers.md)
+- [Contact the student team](https://compbioatberkeley.github.io/contact/)
+
+Canonical public origin: [https://compbioatberkeley.github.io](https://compbioatberkeley.github.io/).

public/agent-instructions.md

@@ -24,7 +24,8 @@ Computational Biology at Berkeley is a UC Berkeley student organization. Use thi
 - The complete index of public HTML pages is at [/sitemap.xml](https://compbioatberkeley.github.io/sitemap.xml).
 - Crawler policy is at [/robots.txt](https://compbioatberkeley.github.io/robots.txt).
 - The concise agent entry point is at [/llms.txt](https://compbioatberkeley.github.io/llms.txt).
-- The site publishes structured Schema.org `Organization`, `EducationalOrganization`, and `WebPage` data in its rendered HTML.
+- Developer resources and explicit API, authentication, webhook, Markdown, and MCP status are at [/developers.md](https://compbioatberkeley.github.io/developers.md).
+- The site publishes structured Schema.org `Organization`, `EducationalOrganization`, `WebSite`, and `WebPage` data in its rendered HTML.
 
 ## Technical capabilities
 

public/developers.md

@@ -0,0 +1,29 @@
+# Developer resources for Computational Biology at Berkeley
+
+> This page indexes the supported machine-readable resources and current technical capability boundaries for the Computational Biology at Berkeley public website.
+
+Canonical public origin: [https://compbioatberkeley.github.io](https://compbioatberkeley.github.io/).
+
+## Supported public resources
+
+- [Developer resource page](https://compbioatberkeley.github.io/developers/): Human-readable HTML version with the same capability status.
+- [Agent guide](https://compbioatberkeley.github.io/llms.txt): Concise source index and annotated public-page links.
+- [Agent instructions](https://compbioatberkeley.github.io/agent-instructions.md): Source-selection, freshness, safety, and action boundaries.
+- [Sitemap](https://compbioatberkeley.github.io/sitemap.xml): Canonical inventory of public HTML pages.
+- [Crawler policy](https://compbioatberkeley.github.io/robots.txt): Crawler access policy and sitemap location.
+- [Website source](https://github.com/CompbioAtBerkeley/compbioatberkeley.github.io): Exact public repository that builds and publishes this static website.
+- [Student project repositories](https://github.com/Compbio-at-berkeley-projects): Public project code; these repositories are not an API contract for this website.
+
+Rendered public pages include Schema.org `Organization`, `EducationalOrganization`, `WebSite`, `WebPage`, `PostalAddress`, and `ContactPoint` JSON-LD. Event details, officer rosters, forms, and recruitment windows are mutable; re-fetch the relevant canonical page for time-sensitive answers.
+
+## API, OpenAPI, authentication, webhook, and MCP status
+
+This static informational website does not offer a public API. Therefore:
+
+- **API docs and OpenAPI:** No application API or OpenAPI specification is published.
+- **Authentication API:** No member accounts, API keys, OAuth clients, or authenticated developer portal are provided by this website.
+- **Webhooks:** No webhook events, signing secrets, delivery guarantees, or retry semantics are offered.
+- **MCP:** Computational Biology at Berkeley does not operate an MCP server for this website. There is no live MCP endpoint or manifest. Do not treat GitHub's MCP tooling, public repositories, or similarly named registry results as a service operated by this organization.
+- **Markdown negotiation:** Explicit Markdown resources such as this file and `agent-instructions.md` are served as `text/markdown`. Same-URL `Accept: text/markdown` negotiation is not available on the current static GitHub Pages origin.
+
+Do not invent API endpoints, authentication flows, webhook subscriptions, tool calls, or transactional capabilities. If an API or MCP service is launched later, this resource index and [llms.txt](https://compbioatberkeley.github.io/llms.txt) will identify the canonical endpoint, protocol version, authorization model, and operational owner.

public/llms.txt

@@ -12,6 +12,7 @@ The organization welcomes students at all experience levels. Event details, offi
 - [Participation](https://compbioatberkeley.github.io/signup/): Use for public ways to join or receive updates; do not claim a form was submitted without confirmation.
 - [Partnerships](https://compbioatberkeley.github.io/collaborations/): Use for research, speaker, sponsorship, and industry collaboration options.
 - [Agent instructions](https://compbioatberkeley.github.io/agent-instructions.md): Use for source-selection rules, safety boundaries, and capability limits.
+- [Developer resources](https://compbioatberkeley.github.io/developers/): Use for machine-readable files and explicit API, OpenAPI, authentication, webhook, Markdown, and MCP capability status.
 
 ## Main pages
 
@@ -23,6 +24,7 @@ The organization welcomes students at all experience levels. Event details, offi
 - [Join](https://compbioatberkeley.github.io/signup/): Interest form, newsletter signup, and community channels.
 - [Contact](https://compbioatberkeley.github.io/contact/): Verified public channels for general questions, partnerships, events, and participation.
 - [Privacy](https://compbioatberkeley.github.io/privacy/): How analytics, browser preferences, embedded services, forms, and external platforms handle information.
+- [Developers](https://compbioatberkeley.github.io/developers/): Supported machine-readable resources and current technical capability boundaries.
 
 ## Contact and community
 
@@ -34,9 +36,10 @@ The organization welcomes students at all experience levels. Event details, offi
 ## Machine-readable resources
 
 - [Agent instructions](https://compbioatberkeley.github.io/agent-instructions.md): Detailed guidance on when to use each source and what agents must not infer or submit.
+- [Developer resource index](https://compbioatberkeley.github.io/developers.md): Markdown index of machine-readable resources and explicit API, authentication, webhook, and MCP status.
 - [Sitemap](https://compbioatberkeley.github.io/sitemap.xml): Canonical index of public HTML pages.
 - [Crawler policy](https://compbioatberkeley.github.io/robots.txt): Current crawler access policy and sitemap location.
-- [Organization identity](https://compbioatberkeley.github.io/): Rendered HTML includes Schema.org Organization, EducationalOrganization, PostalAddress, ContactPoint, and WebPage data.
+- [Organization identity](https://compbioatberkeley.github.io/): Rendered HTML includes Schema.org Organization, EducationalOrganization, WebSite, PostalAddress, ContactPoint, and WebPage data.
 
 ## Optional
 

scripts/lib/site-seo.js

@@ -128,15 +128,19 @@ export const buildPageHtml = ({
 
   html = html.replace(/\s*<meta\s+name="robots"[^>]*>/i, "");
   html = html.replace(/\s*<meta\s+name="google-site-verification"[^>]*>/i, "");
+  html = html.replace(/\s*<link\s+[^>]*data-route-markdown[^>]*>/i, "");
   const robotsMeta = noindex
     ? '<meta name="robots" content="noindex, nofollow" />'
     : '<meta name="robots" content="index, follow" />';
   const verificationMeta = siteIdentity.googleSiteVerification
     ? `<meta name="google-site-verification" content="${escapeHtml(siteIdentity.googleSiteVerification)}" />`
     : "";
+  const markdownAlternate = page.markdownPath
+    ? `<link rel="alternate" href="${escapeHtml(canonicalUrl(siteOrigin, page.markdownPath))}" type="text/markdown" data-route-markdown />`
+    : "";
   html = html.replace(
     "</head>",
-    `    ${robotsMeta}\n    ${verificationMeta}\n    <script id="site-structured-data" type="application/ld+json">${jsonForHtml(structuredData)}</script>\n  </head>`,
+    `    ${robotsMeta}\n    ${verificationMeta}\n    ${markdownAlternate}\n    <script id="site-structured-data" type="application/ld+json">${jsonForHtml(structuredData)}</script>\n  </head>`,
   );
   html = replaceRequired(
     html,