Merge pull request #20 from HaoZeke/docs/manual-discovery

docs(manual): point the index at the discovery files

Author: HaoZeke

CHANGELOG.md

@@ -158,6 +158,9 @@ All notable changes to this project are documented here.
   `--easystack`, `--easyconfigs`, `--installed`, `--profile`,
   `--resources`, `--node`, `--job-memory` (alias `--mib-per-job`),
   `--hooks`, `--parallel`, and `--max-parallel`.
+- The manual index links `llms.txt`, `llms-full.txt`, `AGENTS.md`, the
+  skills directory, and `server.json`, the same discovery files the
+  README names. Client setup stays on the Model Context Protocol page.
 - How to split one Jenkins build list into shards that build at the
   same time, with the shared dependencies in a prelude.
 - How to plan software-layer pull requests whose builds do not overlap,

docs/orgmode/index.org

@@ -389,6 +389,20 @@ Rohit Goswami, eb-stack (source revision <commit>), https://github.com/HaoZeke/e
 
   MIT License. See [[https://github.com/HaoZeke/eb-stack/blob/main/LICENSE][LICENSE]] in the repository.
 
+* Discovery
+
+  [[https://github.com/HaoZeke/eb-stack/blob/main/llms.txt][llms.txt]] indexes
+  this manual.
+  [[https://github.com/HaoZeke/eb-stack/blob/main/llms-full.txt][llms-full.txt]]
+  repeats every page in one file.
+  [[https://github.com/HaoZeke/eb-stack/blob/main/AGENTS.md][AGENTS.md]] lists
+  the build, test, lint, and docs commands. The skills for inspect, plan,
+  bump, a stack SBOM, pull-request overlap, and the stdio server are under
+  [[https://github.com/HaoZeke/eb-stack/tree/main/skills][skills/]]. The Model
+  Context Protocol manifest is
+  [[https://github.com/HaoZeke/eb-stack/blob/main/server.json][server.json]].
+  Client configuration is the [[file:reference/mcp.org][server page]].
+
 * Build these docs
 
 #+begin_src bash

llms-full.txt

@@ -157,6 +157,20 @@ Rohit Goswami, eb-stack (source revision <commit>), https://github.com/HaoZeke/e
 
   MIT License. See [LICENSE](https://github.com/HaoZeke/eb-stack/blob/main/LICENSE) in the repository.
 
+# Discovery
+
+  [llms.txt](https://github.com/HaoZeke/eb-stack/blob/main/llms.txt) indexes
+  this manual.
+  [llms-full.txt](https://github.com/HaoZeke/eb-stack/blob/main/llms-full.txt)
+  repeats every page in one file.
+  [AGENTS.md](https://github.com/HaoZeke/eb-stack/blob/main/AGENTS.md) lists
+  the build, test, lint, and docs commands. The skills for inspect, plan,
+  bump, a stack SBOM, pull-request overlap, and the stdio server are under
+  [skills/](https://github.com/HaoZeke/eb-stack/tree/main/skills). The Model
+  Context Protocol manifest is
+  [server.json](https://github.com/HaoZeke/eb-stack/blob/main/server.json).
+  Client configuration is the [server page](https://eb-stack.rgoswami.me/reference/mcp.html.md).
+
 # Build these docs
 
 ```bash

tests/public_metadata.rs

@@ -592,4 +592,19 @@ fn discovery_metadata_uses_real_index_terms() {
     ] {
         assert!(readme.contains(needle), "README must point at {needle}");
     }
+
+    let index = std::fs::read_to_string(root.join("docs/orgmode/index.org")).expect("read index");
+    for needle in [
+        "llms.txt",
+        "llms-full.txt",
+        "AGENTS.md",
+        "server.json",
+        "skills/",
+        "reference/mcp.org",
+    ] {
+        assert!(
+            index.contains(needle),
+            "manual index must point at {needle}"
+        );
+    }
 }