chitta.md — the field of mind

what if you could give an ai agent
the full context of who you are?

not a resume. not a bio. not a list of skills.
but the way you actually think — the frameworks you reach for,
the patterns you've accumulated, the values you won't compromise,
the influences that shaped how you see the world.

in the yoga sūtras, patañjali calls this chitta —
the complete field of consciousness. memory, intellect, identity, patterns.
everything that makes you you as a thinking being.

the landscape

markdown is the new handshake
between humans and ai

agents.md tells ai how to work in your codebase.
soul.md defines an ai's personality and values.
skill.md packages capabilities agents can discover.
llms.txt makes websites readable to ai.

every major tool — copilot, cursor, claude, gemini, codex — now reads markdown files as its primary interface with human intent.

but there's a gap. all of these define the system. none of them define you.

darshana

दर्शन

sanskrit: dṛś — "to see" literally: "seeing, vision, philosophical viewpoint"
a system of seeing — how one perceives and interprets reality. in indian philosophy, each darshana is a complete worldview.

worldview — philosophical os

references.md

models.md

collections.md

the deepest layer. the thinkers who shaped how you see reality, the mental models you reach for instinctively, the traditions you keep returning to. darshana isn't what you've read — it's what has changed you.

"we don't see the world as it is. we see it as we are."

— anaïs nin (via the talmud)

reference

nassim nicholas taleb

uncertainty, antifragility, skin in the game. positioning over prediction.

reference

adi shankara

non-duality. the illusion of separation dissolves upon inquiry.

model

neti neti

"not this, not this." discovering what you are by eliminating what you are not.

collection

advaita vedanta

non-duality. atman and brahman are one. the wave is the ocean.

feeds into →

→ taleb's via negativa becomes a decision framework in buddhi

→ advaita's witness consciousness shapes the values in ahaṃkāra

→ stoicism's dichotomy of control informs how tradeoffs are weighed in buddhi

buddhi

बुद्धि

sanskrit: budh — "to awaken, to know" literally: "intelligence, discernment, the faculty of judgment"
the aspect of mind that discriminates, decides, and determines. the inner compass that says "this, not that."

discernment — how I think

frameworks.md

principles.md

tradeoffs.md

where darshana is the raw source material, buddhi is your personal synthesis. the frameworks you actually use to make decisions. not taleb's antifragility in the abstract — but how you apply it when choosing between two architectures, or deciding what to build next.

"the test of a first-rate intelligence is the ability to hold two opposed ideas in mind at the same time and still retain the ability to function."

— f. scott fitzgerald

informed by ← / feeds into →

← darshana provides the philosophical raw material

→ decision frameworks shape the working style and tools in saṃskāra

↔ smṛti feeds lessons back — frameworks refined by lived experience

saṃskāra

संस्कार

sanskrit: sam + kṛ — "to put together, to refine" literally: "impressions, conditioning, mental formations"
the traces left by past actions and experiences. the grooves in consciousness that shape how you respond before thinking.

patterns — accumulated experience

background.md

style.md

tools.md

the grooves worn by years of practice. how you actually work — not the theory, but the muscle memory. your communication style, the tools you reach for, the professional patterns that have become second nature. saṃskāras are impressions left by experience — they're what make you efficient without thinking.

"we are what we repeatedly do. excellence, then, is not an act, but a habit."

— will durant (summarizing aristotle)

shaped by ← / expresses as →

← buddhi frameworks shape what patterns form

→ patterns crystallize into the identity and boundaries of ahaṃkāra

← smṛti stores the lessons that refined these patterns

ahaṃkāra

अहंकार

sanskrit: aham + kāra — "I" + "maker" literally: "the I-maker, the sense of individual self"
the faculty that creates the sense of "I am." not ego in the western pejorative sense, but the conscious principle of identity and self-definition.

identity — what I stand for

values.md

roles.md

boundaries.md

the sense of self that says "this is who I am, this is what I will and won't do." values, roles, boundaries. ahaṃkāra is often translated as "ego" — but here it means something deeper: the conscious choices about what you stand for. not the ego that defends, but the identity that chooses.

"between stimulus and response there is a space. in that space is our freedom and our power to choose our response."

— viktor frankl

emerges from ← / visible in →

← identity emerges from the intersection of darshana (what you believe), buddhi (how you think), and saṃskāra (how you act)

→ visible in every vṛtti — your writing, your choices, your evolution

smṛti

स्मृति

sanskrit: smṛ — "to remember" literally: "memory, remembrance, that which is remembered"
in the yoga sūtras, one of the five vṛttis. the power of retention — holding past experience in present awareness. the thread of continuity across time.

memory — the thread

now.md

lessons.md

influences.md

smṛti isn't a layer — it's the thread that connects all layers. memory draws from darshana (the influences that persist), is shaped by saṃskāra (the lessons that stick), and feeds back into buddhi (frameworks refined by lived experience). it's the living context — what's active in consciousness right now.

"the only reason for time is so that everything doesn't happen at once."

— albert einstein

connects ↔ everything

↔ darshana — which influences persist in active memory

↔ buddhi — frameworks refined by what you've learned

↔ saṃskāra — lessons that shaped your patterns

↔ ahaṃkāra — the experiences that defined your boundaries

vṛtti

वृत्ति

sanskrit: vṛt — "to turn, to revolve" literally: "whirlpool, fluctuation, modification of mind"
the movements on the surface of consciousness. in the yoga sūtras, the five vṛttis are the activities of chitta that yoga seeks to still.

fluctuations — the surface

interests.md

writing.md

changelog.md

the visible surface of consciousness — always moving, always changing. your current interests, your published writing, the record of how your thinking has evolved. vṛttis are the waves on the ocean. they're what people see. but they only make sense in the context of everything below.

"yogaś citta-vṛtti-nirodhaḥ" — yoga is the stilling of the fluctuations of chitta.

— patañjali, yoga sūtras 1.2

emerges from ← everything

← writing emerges from buddhi (frameworks applied to current thinking)

← interests are pulled by darshana (the worldview seeking new input)

← the changelog tracks how ahaṃkāra evolves over time

the complete field

chitta

darshana

worldview

buddhi

discernment

saṃskāra

patterns

ahaṃkāra

identity

smṛti

thread

vṛtti

surface

chitta is not six separate files. it's one field. darshana feeds buddhi. buddhi shapes saṃskāra. saṃskāra expresses as ahaṃkāra. smṛti threads through everything. and vṛtti is the visible surface — the waves you can see on the ocean of everything underneath.

how agents read your chitta

different agents need different layers. a coding agent doesn't need your philosophical influences. a writing agent doesn't need your tool preferences. chitta.md lets each agent read exactly the context it needs.

coding agent — reads buddhi + saṃskāra

$ cat chitta/buddhi/frameworks.md | head -5 ## decision frameworks - via negativa: remove before adding - skin in the game: no advice without exposure - second-order thinking: then what? $ cat chitta/samskara/style.md | head -3 ## working style - prefers small, reversible changes over big rewrites - values clarity over cleverness # → agent now writes code matching your actual patterns

writing agent — reads darshana + vṛtti

$ cat chitta/darshana/references.md | grep taleb ## nassim nicholas taleb core thesis: we systematically underestimate uncertainty key ideas: black swans, antifragility, via negativa $ cat chitta/vrtti/interests.md currently exploring: .md domain standards for ai agents # → agent writes in your voice, references your frameworks

new collaborator — reads ahaṃkāra + smṛti

$ cat chitta/ahamkara/values.md ## non-negotiables - ship with tests. no exceptions. - transparency over comfort $ cat chitta/smrti/now.md ## current focus: q1 2026 - building product ops tooling for trustlayer - exploring chitta.md as a personal context standard # → collaborator understands your boundaries and context

"a soul document defines who an ai is — not what it can do, but who it chooses to be."

chitta.md is the same thing, but for the human.

— an ancient model of consciousness in a modern format

explore chitta.md → araujo.md

chitta.md the totality of mind — a human spec file

what if you could give an ai agentthe full context of who you are?

markdown is the new handshakebetween humans and ai

the complete field

how agents read your chitta

what if you could give an ai agent
the full context of who you are?

markdown is the new handshake
between humans and ai