AGENTS — himuatri.xyz

// purpose

This is the official website for Himujjal Upadhyaya (public persona: Himu Atri) — a startup and tech consultancy. The public/ folder is the source for himuatri.surge.sh.

The site exists to help people understand what Himu does and how he can help. Every page should answer one question: "What can Himu do for you?"

// profiles

github.com/Himujjal ← 137 repos codeberg.org/himuatri ← 3 repos linkedin.com/in/himuup x.com/himu_up

// professional boundaries

• No PII: Never include phone numbers, personal addresses, family member names, land records, or any identifiable private data
• Public persona: "Himu Atri" — not legal aliases, not family names
• Full name: "Himujjal Upadhyaya" — used on the website for professional transparency
• Contact: Telegram (t.me/himu_atri), Signal (@himu.97)
• Do NOT include email addresses or phone numbers in any file

// file conventions

• Every .md file must have a corresponding .html file
• Frontmatter fields: id, aliases, tags
• Use [[wikilinks]] for internal Obsidian links
• Tags follow lowercase-kebab-case: blog, micro-blog, meta
• All HTML files share main.js
• All HTML files link only styles.css (the compiled Tailwind output); do NOT link main.css directly

// directory structure

        public/
        AGENTS.md ← Agent instructions
        AGENTS.html ← Rendered instructions (this page)
        index.md ← Main index source
        index.html ← Main landing page
        main.css ← Shared styles (source)
        main.js ← Shared scripts
        resume.html ← Resume page
        resume-slides.html ← Resume presentation (Reveal.js)
        slide.md ← About me slide source
        slide.html ← About me slide (Reveal.js)
        fractional.md ← Fractional CTO source
        fractional.html ← Fractional CTO page
        styles.css ← Tailwind output (generated from main.css)
        dev.ts ← Dev server
        blogs/ ← Consulting blog posts
        assets/
          fonts/ ← Self-hosted fonts (DM Sans)
          icons/ ← Favicons
          images/ ← Profile images

// what this site is about

Himu is a startup and tech consultant. That means:

Build

From idea to shipped product. Apps, platforms, tools.

Fix

Broken, slow, or falling apart? Find the problem and make it work.

Think

Architecture, systems design, infrastructure — the hard problems.

// voice & tone

→ Warm and honest: Write like a person, not a brand.
→ Clear over clever: Confused visitors leave. Simplify.
→ Soft confidence: State what you can do without bragging.
→ No hype: Avoid "world-class", "cutting-edge", "disrupting".
→ Practical: Show, don't tell. Describe the problem solved.
→ Approachable: A first-time founder should feel comfortable reaching out.

// design system — "chandan paper"

Colors

#faf4eb bg surface #241810 text #4a3120 secondary #7a5a3e tertiary #d97c2b accent

Typography

Inter (headlines + body) · JetBrains Mono (code)

Animation Rules

• Every animation under 300ms
• prefers-reduced-motion disables everything
• Boot sequence: 1.8s, skips if reduced motion
• Scroll reveals: fade + slide up 30px
• No parallax, no music, no sound

Anti-Patterns

✕ Stock photos or illustrations
✕ Fake testimonials or "trusted by" sections
✕ Popup modals or newsletter signups
✕ Email addresses or phone numbers
✕ Parallax scrolling, music, sound effects

// hard rejections — audit checklist

Every post linked from index.md must pass ALL checks.

Rejected Frontmatter Tags

adhd · mental_health · health · personal · memoir

Rejected Content

• Names beyond "Himu Atri" · Family references · Childhood stories
• Relationship stories · Personal health · Emotional confessionals
• Productivity struggles · Crude language · Legal names in footers

Allowed Categories

Programming & Tech · Consulting & Services · Education & Systems · Society & Data · Outputs

// stack reference

• Static hosting: Surge.sh
• Editor: Obsidian + Neovim
• Version control: Git
• Dev server: bun run public/dev.ts (Tailwind CLI + Bun :5005)