{"schema":"nanaos.agent-interface/v1","document":"NANA_OS_AGENT_INTERFACE","language":"en","identity":{"brand":"nanaOS","product":"nanaOS Design System","slogan":"Stop fighting your agent. Give it product-ready code, not a prompt.","category":"AI-native, code-first design operating system","purpose":"Turn shared product intent into one traceable source of truth for people, products, and agents.","package":"@nanaorbit/nanaos"},"creator":{"name":"Nana","handle":"nanacodesign","role":"Product designer and design-system author","relationship":"Creator and maintainer of nanaOS","pointOfView":"A design system is a codesign system: shared intent should remain legible to both humans and machines.","profile":"https://github.com/nanacodesign"},"principles":["Consistency","Scalable","Maintainable","DRY (Don't Repeat Yourself)","Agent-friendly"],"architecture":{"direction":"downward-only","expression":"base → primitives → semantics → (rules ∥ capabilities) → components → patterns","layers":[{"name":"base","role":"Non-emitting utilities and reset."},{"name":"primitives","role":"Raw values; forbidden as component dependencies."},{"name":"semantics","role":"Intent-bearing tokens consumed by components."},{"name":"rules","role":"Enforceable accessibility and system laws."},{"name":"capabilities","role":"Reusable behavior adapters parallel to rules."},{"name":"components","role":"Recipe-backed production UI."},{"name":"patterns","role":"Recommended public-API compositions."}]},"retrieval":{"public":[{"href":"https://nanaos-ai-design-system.nana-codesign.chatgpt.site/llms.txt","type":"text/plain","purpose":"Fast orientation and read order."},{"href":"https://nanaos-ai-design-system.nana-codesign.chatgpt.site/agent.json","type":"application/json","purpose":"Canonical public machine manifest."},{"href":"https://nanaos-ai-design-system.nana-codesign.chatgpt.site/agent","type":"text/html","purpose":"Semantic, text-first Agent Interface."},{"href":"https://nanaos-ai-design-system.nana-codesign.chatgpt.site/#index","type":"text/html","purpose":"Human-visible System Index search."}],"authorizedPackage":["contracts/tokens.json","contracts/components.json","contracts/constraints.json","contracts/taxonomy.json","contracts/recommendations.json","ADOPTION.md"],"sourcePrecedence":["Active canon","Authored source and component recipes","Generated contracts","Canonical examples","Historical ADRs for rationale"]},"instructions":["Understand the product anatomy, repeated needs, states, and accessibility constraints before naming a token or component.","Determine intent before choosing a visual treatment.","Prefer measured primitives and compatible semantic aliases so the vocabulary can grow without renaming existing decisions.","Search the inventory and recommendations before proposing a token, component, or pattern.","Components consume semantic tokens only; primitive tokens are not component APIs.","Respect the downward-only layer dependency rule.","Treat generated contracts as read-only projections of authored source.","Use public component APIs when composing patterns.","Do not invent missing system facts; ask Nana when confidence is below 0.75 or a new system primitive is required."],"transformation":["intent","recipe","validation","generation","documentation","audit","versioned distribution"],"access":{"publicWebsite":true,"implementation":"proprietary","package":"authorized consumers only","boundary":"The public manifest explains the system without publishing private implementation contracts."},"canonical":"https://nanaos-ai-design-system.nana-codesign.chatgpt.site/agent","request":null}