# yashpersonal

> Assignment

- Documentation: https://yashpersonal.thally.app
- GitHub: https://github.com/yash251/yashpersonaldocs
- Full docs for LLMs: https://yashpersonal.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://yashpersonal.thally.app/ai.txt
- Structured docs index (JSON): https://yashpersonal.thally.app/api/docs-index
- OpenAPI spec: https://yashpersonal.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://yashpersonal.thally.app/api/docs/{page-id}
- Search API: https://yashpersonal.thally.app/api/search?q={query}
- Capability manifest (skill): https://yashpersonal.thally.app/skill.md
- Agent guidance (editing these docs): https://yashpersonal.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://yashpersonal.thally.app/api/mcp
- Agent readiness: https://yashpersonal.thally.app/api/agent-readiness
- Changelog feed (JSON Feed): https://yashpersonal.thally.app/changelog/feed.json
- Changelog feed (RSS): https://yashpersonal.thally.app/changelog/rss.xml

### Recommended workflow

1. Use this index, the search API, or `search_sections` / `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://yashpersonal.thally.app/): What subgraphs are, who this handbook is for, and where to start.
- [Quickstart](https://yashpersonal.thally.app/quickstart): Deploy a subgraph for a verified Ethereum contract to Subgraph Studio and run your first GraphQL query.

## Guides

### Operate

- [Debug a failed subgraph](https://yashpersonal.thally.app/guides/debug-a-failed-subgraph): Read the indexing status, decode the fatal error, and fix the failure modes that account for most support tickets.

## Changelog

- [Changelog](https://yashpersonal.thally.app/changelog): What changed in the Subgraph Handbook, newest first, so returning readers know which pages to reread.