Source of Truth View

Managing a project knowledge base in Markdown is great for version control but tedious for navigation. This skill bridges the gap between raw docs and a readable interface by serving your Source of Truth (SoT) knowledge base as a local web view. It handles the logistics of finding the kb.html file, checking for stale content, and launching a background server so you can browse your documentation in a browser.

What it does

• Locate view files by scanning for the view/kb.html generated by Source of Truth.
• Freshness validation to alert you if the Markdown source files have been updated since the last build.
• Local web serving using Python or native background processes to host the knowledge base on a secure local port.
• Remote port forwarding instructions for developers working in cloud environments, containers, or remote IDEs.
• Process management to start, monitor, and gracefully shut down the background server when you are finished.

How it works

1. Locate: The agent finds the knowledge-base/ directory and verifies the existence of the HTML view.
2. Verify: It compares timestamps between the Markdown source and the HTML view to ensure you are seeing the latest data.
3. Serve: It initiates a static server bound to 127.0.0.1 on a free port (starting at 8765).
4. Access: You receive a local URL or instructions for SSH tunneling if working remotely.

Frameworks & tools

Requires an environment with file system access and a static file server capability, typically using Python 3 (http.server). It is designed specifically for knowledge bases built using the Source of Truth (SoT) framework.

Why this beats prompting it yourself

Prompting an agent to "open a file" often fails in remote or containerized environments where simple file paths don't resolve in a browser. This skill automates the background process management and port binding logic needed to make documentation actually accessible across different dev environments.

Use cases

• Previewing documentation locally before committing changes to a repository.
• Sharing a rendered view of a project knowledge base during a pair programming session.
• Accessing searchable documentation in a browser while coding in a terminal-based editor.

Known limitations

Does not generate or update the knowledge base; it only serves existing builds. Limited to 127.0.0.1 by default for security. Requires Python 3 for the server component.