Skip to content

Commit 7a6abdb

Browse files
Siddhant-K-codeona-agent
Siddhant-K-code
and
ona-agent
committed
Initial site: Astro + Tailwind, 33 chapters from Typst, editorial design
- Astro static site with MDX content collections - Geist + Geist Mono typography, monochrome palette (Factory.ai / Stripe.dev style) - Dark mode default with light mode toggle - Sidebar navigation grouped by Part, scroll-spy ToC - All 33 chapters + 4 appendices + preface/epilogue converted from Typst - GitHub Actions workflow for GitHub Pages deployment - GA4 placeholder (set PUBLIC_GA_ID repo variable to activate) - Sitemap, OG tags, Twitter cards, robots.txt - CC BY-NC-SA 4.0 license Co-authored-by: Ona <no-reply@ona.com>
0 parents  commit 7a6abdb

76 files changed

Lines changed: 17184 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/deploy.yml‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
name: Deploy to GitHub Pages
2+
3+
on:
4+
push:
5+
branches: [main]
6+
workflow_dispatch:
7+
8+
permissions:
9+
contents: read
10+
pages: write
11+
id-token: write
12+
13+
concurrency:
14+
group: pages
15+
cancel-in-progress: true
16+
17+
jobs:
18+
build:
19+
runs-on: ubuntu-latest
20+
steps:
21+
- uses: actions/checkout@v4
22+
23+
- uses: actions/setup-node@v4
24+
with:
25+
node-version: 22
26+
cache: npm
27+
28+
- run: npm ci
29+
30+
- run: npm run build
31+
env:
32+
PUBLIC_GA_ID: ${{ vars.PUBLIC_GA_ID }}
33+
34+
- uses: actions/upload-pages-artifact@v3
35+
with:
36+
path: dist
37+
38+
deploy:
39+
needs: build
40+
runs-on: ubuntu-latest
41+
environment:
42+
name: github-pages
43+
url: ${{ steps.deployment.outputs.page_url }}
44+
steps:
45+
- id: deployment
46+
uses: actions/deploy-pages@v4

‎.gitignore‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Dependencies
2+
node_modules/
3+
4+
# Build
5+
dist/
6+
7+
# Environment
8+
.env
9+
.env.local
10+
.env.*.local
11+
12+
# IDE
13+
.vscode/
14+
.idea/
15+
*.swp
16+
*.swo
17+
.DS_Store
18+
19+
# Debug
20+
npm-debug.log*
21+
yarn-debug.log*
22+
yarn-error.log*
23+
24+
# Astro
25+
.astro/

‎CONTRIBUTING.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Contributing
2+
3+
Contributions that improve accuracy and clarity are welcome.
4+
5+
## In scope
6+
7+
- Typo and grammar fixes
8+
- Broken link corrections
9+
- Factual corrections with a source
10+
- Clarifications to ambiguous passages
11+
12+
## Out of scope
13+
14+
- New chapters or major content additions
15+
- Rewriting existing sections
16+
- Adding promotional content
17+
18+
## How to contribute
19+
20+
1. Open an issue describing the problem
21+
2. If you'd like to fix it yourself, fork the repo and submit a PR
22+
3. Reference the issue number in your PR
23+
24+
## Style
25+
26+
- Match the existing tone: direct, technical, no marketing language
27+
- Use present tense
28+
- Keep sentences short
29+
30+
## License
31+
32+
By contributing, you agree that your contributions will be licensed under CC BY-NC-SA 4.0.

‎LICENSE‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
2+
3+
Copyright (c) 2026 Siddhant Khare
4+
5+
You are free to:
6+
7+
Share — copy and redistribute the material in any medium or format
8+
Adapt — remix, transform, and build upon the material
9+
10+
Under the following terms:
11+
12+
Attribution — You must give appropriate credit, provide a link to the
13+
license, and indicate if changes were made.
14+
15+
NonCommercial — You may not use the material for commercial purposes.
16+
17+
ShareAlike — If you remix, transform, or build upon the material, you
18+
must distribute your contributions under the same license.
19+
20+
No additional restrictions — You may not apply legal terms or
21+
technological measures that legally restrict others from doing anything
22+
the license permits.
23+
24+
Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode

‎README.md‎

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
# The Agentic Engineering Guide
2+
3+
Concepts, workflows, and team practices for AI agent infrastructure.
4+
5+
**10 Parts · 33 Chapters · 4 Appendices**
6+
7+
By [Siddhant Khare](https://siddhantkhare.com) · February 2026
8+
9+
---
10+
11+
## Read online
12+
13+
[**siddhant-k-code.github.io/agentic-engineering-guide**](https://siddhant-k-code.github.io/agentic-engineering-guide)
14+
15+
## Buy the book
16+
17+
[**siddhantkhare.gumroad.com**](https://siddhantkhare.gumroad.com)
18+
19+
---
20+
21+
## Table of Contents
22+
23+
### Part I — Foundations
24+
1. The Agentic Engineering Landscape
25+
2. The Capability Jump
26+
3. The Agentic AI Foundation & Standards
27+
28+
### Part II — Context Engineering
29+
4. Context Windows
30+
5. The Context Engineering Stack
31+
6. RAG vs. Agentic Search
32+
33+
### Part III — Security & Authorization
34+
7. The Agent Security Crisis
35+
8. Zanzibar for AI Agents
36+
9. Prompt Injection & Tool Poisoning
37+
10. Sandboxing & Runtime Protection
38+
39+
### Part IV — Protocols & Standards
40+
11. Model Context Protocol (MCP)
41+
12. Agent-to-Agent Communication (A2A)
42+
13. AGENTS.md & Codebase Onboarding
43+
44+
### Part V — Observability & Operations
45+
14. Agent Traces & OpenTelemetry
46+
15. Cost Tracking & Token Economics
47+
16. Incident Response for Agent Failures
48+
49+
### Part VI — Agent Orchestration
50+
17. The Agent Loop
51+
18. Multi-Agent Systems
52+
19. Agent Memory & Checkpoints
53+
54+
### Part VII — Team Practices
55+
20. AI Fatigue & Sustainable Adoption
56+
21. The Conductor Model
57+
22. Agent Maturity Model
58+
59+
### Part VIII — Production Workflows
60+
23. Your First Agent in Production
61+
24. Security Checklist & Review Policies
62+
25. Measuring Agent Impact
63+
64+
### Part IX — Production Engineering
65+
26. Agent Evaluation & Testing
66+
27. Enterprise Adoption & Vendor Strategy
67+
28. Agent Cost Control & FinOps
68+
29. Agent Governance & Compliance
69+
30. Structured Outputs & Function Calling
70+
31. Model Selection & Routing
71+
72+
### Part X — Sustainability & Deployment
73+
32. Backpressure & Automated Feedback
74+
33. The Agent Adoption Playbook
75+
76+
### Appendices
77+
- A: Tool & Framework Directory
78+
- B: Glossary
79+
- C: Further Reading & References
80+
- D: Templates & Checklists
81+
82+
---
83+
84+
## Development
85+
86+
```bash
87+
npm install
88+
npm run dev
89+
```
90+
91+
Build for production:
92+
93+
```bash
94+
npm run build
95+
```
96+
97+
## Tech stack
98+
99+
- [Astro](https://astro.build) — static site generator
100+
- [Tailwind CSS](https://tailwindcss.com) — styling
101+
- [MDX](https://mdxjs.com) — content format
102+
- [Geist](https://vercel.com/font) — typography
103+
104+
## License
105+
106+
Content is licensed under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/).
107+
108+
Copyright 2026 Siddhant Khare.

‎astro.config.mjs‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
import { defineConfig } from "astro/config";
2+
import mdx from "@astrojs/mdx";
3+
import sitemap from "@astrojs/sitemap";
4+
import tailwindcss from "@tailwindcss/vite";
5+
6+
export default defineConfig({
7+
site: "https://siddhant-k-code.github.io",
8+
base: "/agentic-engineering-guide",
9+
integrations: [mdx(), sitemap()],
10+
vite: {
11+
plugins: [tailwindcss()],
12+
},
13+
markdown: {
14+
shikiConfig: {
15+
themes: {
16+
light: "github-light",
17+
dark: "github-dark",
18+
},
19+
},
20+
},
21+
});

0 commit comments

Comments
 (0)