axiom-coding-agent-setup 1.0.9 → 1.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/.agents/skills/agent-browser/SKILL.md +55 -0
  2. package/.agents/skills/developing-with-streamlit/SKILL.md +220 -0
  3. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-chat-ui/SKILL.md +195 -0
  4. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-custom-components-v2/SKILL.md +233 -0
  5. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-custom-components-v2/references/packaged-components.md +212 -0
  6. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-custom-components-v2/references/state-sync.md +149 -0
  7. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-custom-components-v2/references/theme-css-variables.md +243 -0
  8. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-custom-components-v2/references/troubleshooting.md +121 -0
  9. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-dashboards/SKILL.md +147 -0
  10. package/.agents/skills/developing-with-streamlit/skills/building-streamlit-multipage-apps/SKILL.md +218 -0
  11. package/.agents/skills/developing-with-streamlit/skills/choosing-streamlit-selection-widgets/SKILL.md +139 -0
  12. package/.agents/skills/developing-with-streamlit/skills/connecting-streamlit-to-snowflake/SKILL.md +188 -0
  13. package/.agents/skills/developing-with-streamlit/skills/creating-streamlit-themes/SKILL.md +486 -0
  14. package/.agents/skills/developing-with-streamlit/skills/displaying-streamlit-data/SKILL.md +199 -0
  15. package/.agents/skills/developing-with-streamlit/skills/improving-streamlit-design/SKILL.md +191 -0
  16. package/.agents/skills/developing-with-streamlit/skills/optimizing-streamlit-performance/SKILL.md +323 -0
  17. package/.agents/skills/developing-with-streamlit/skills/organizing-streamlit-code/SKILL.md +91 -0
  18. package/.agents/skills/developing-with-streamlit/skills/setting-up-streamlit-environment/SKILL.md +128 -0
  19. package/.agents/skills/developing-with-streamlit/skills/using-streamlit-cli/SKILL.md +165 -0
  20. package/.agents/skills/developing-with-streamlit/skills/using-streamlit-custom-components/SKILL.md +170 -0
  21. package/.agents/skills/developing-with-streamlit/skills/using-streamlit-layouts/SKILL.md +229 -0
  22. package/.agents/skills/developing-with-streamlit/skills/using-streamlit-markdown/SKILL.md +207 -0
  23. package/.agents/skills/developing-with-streamlit/skills/using-streamlit-session-state/SKILL.md +144 -0
  24. package/.agents/skills/developing-with-streamlit/templates/.gitattributes +3 -0
  25. package/.agents/skills/developing-with-streamlit/templates/apps/README.md +188 -0
  26. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-companies/pyproject.toml +12 -0
  27. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-companies/streamlit_app.py +365 -0
  28. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-compute/pyproject.toml +12 -0
  29. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-compute/streamlit_app.py +461 -0
  30. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-compute-snowflake/.streamlit/secrets.toml.example +20 -0
  31. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-compute-snowflake/pyproject.toml +11 -0
  32. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-compute-snowflake/snowflake.yml +18 -0
  33. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-compute-snowflake/streamlit_app.py +527 -0
  34. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-feature-usage/pyproject.toml +12 -0
  35. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-feature-usage/streamlit_app.py +307 -0
  36. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-metrics/pyproject.toml +12 -0
  37. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-metrics/streamlit_app.py +426 -0
  38. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-metrics-snowflake/.streamlit/secrets.toml.example +20 -0
  39. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-metrics-snowflake/pyproject.toml +11 -0
  40. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-metrics-snowflake/snowflake.yml +18 -0
  41. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-metrics-snowflake/streamlit_app.py +463 -0
  42. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-seattle-weather/pyproject.toml +12 -0
  43. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-seattle-weather/streamlit_app.py +252 -0
  44. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-stock-peers/pyproject.toml +12 -0
  45. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-stock-peers/streamlit_app.py +342 -0
  46. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-stock-peers-snowflake/.streamlit/secrets.toml.example +20 -0
  47. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-stock-peers-snowflake/pyproject.toml +11 -0
  48. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-stock-peers-snowflake/snowflake.yml +18 -0
  49. package/.agents/skills/developing-with-streamlit/templates/apps/dashboard-stock-peers-snowflake/streamlit_app.py +384 -0
  50. package/.agents/skills/developing-with-streamlit/templates/themes/README.md +128 -0
  51. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/dracula.toml +39 -0
  52. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/github.toml +37 -0
  53. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/minimal.toml +39 -0
  54. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/nord.toml +39 -0
  55. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/snowflake.toml +42 -0
  56. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/solarized-light.toml +38 -0
  57. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/spotify.toml +34 -0
  58. package/.agents/skills/developing-with-streamlit/templates/themes/_configs/stripe.toml +35 -0
  59. package/.agents/skills/developing-with-streamlit/templates/themes/_shared/streamlit_app.py +336 -0
  60. package/.agents/skills/developing-with-streamlit/templates/themes/_templates/pyproject.toml.tmpl +12 -0
  61. package/.agents/skills/developing-with-streamlit/templates/themes/dracula/.streamlit/config.toml +39 -0
  62. package/.agents/skills/developing-with-streamlit/templates/themes/dracula/pyproject.toml +10 -0
  63. package/.agents/skills/developing-with-streamlit/templates/themes/dracula/streamlit_app.py +337 -0
  64. package/.agents/skills/developing-with-streamlit/templates/themes/github/.streamlit/config.toml +37 -0
  65. package/.agents/skills/developing-with-streamlit/templates/themes/github/pyproject.toml +10 -0
  66. package/.agents/skills/developing-with-streamlit/templates/themes/github/streamlit_app.py +337 -0
  67. package/.agents/skills/developing-with-streamlit/templates/themes/manage.py +332 -0
  68. package/.agents/skills/developing-with-streamlit/templates/themes/minimal/.streamlit/config.toml +39 -0
  69. package/.agents/skills/developing-with-streamlit/templates/themes/minimal/pyproject.toml +10 -0
  70. package/.agents/skills/developing-with-streamlit/templates/themes/minimal/streamlit_app.py +337 -0
  71. package/.agents/skills/developing-with-streamlit/templates/themes/nord/.streamlit/config.toml +39 -0
  72. package/.agents/skills/developing-with-streamlit/templates/themes/nord/pyproject.toml +10 -0
  73. package/.agents/skills/developing-with-streamlit/templates/themes/nord/streamlit_app.py +337 -0
  74. package/.agents/skills/developing-with-streamlit/templates/themes/snowflake/.streamlit/config.toml +42 -0
  75. package/.agents/skills/developing-with-streamlit/templates/themes/snowflake/pyproject.toml +10 -0
  76. package/.agents/skills/developing-with-streamlit/templates/themes/snowflake/streamlit_app.py +337 -0
  77. package/.agents/skills/developing-with-streamlit/templates/themes/solarized-light/.streamlit/config.toml +38 -0
  78. package/.agents/skills/developing-with-streamlit/templates/themes/solarized-light/pyproject.toml +10 -0
  79. package/.agents/skills/developing-with-streamlit/templates/themes/solarized-light/streamlit_app.py +337 -0
  80. package/.agents/skills/developing-with-streamlit/templates/themes/spotify/.streamlit/config.toml +34 -0
  81. package/.agents/skills/developing-with-streamlit/templates/themes/spotify/pyproject.toml +10 -0
  82. package/.agents/skills/developing-with-streamlit/templates/themes/spotify/streamlit_app.py +337 -0
  83. package/.agents/skills/developing-with-streamlit/templates/themes/stripe/.streamlit/config.toml +35 -0
  84. package/.agents/skills/developing-with-streamlit/templates/themes/stripe/pyproject.toml +10 -0
  85. package/.agents/skills/developing-with-streamlit/templates/themes/stripe/streamlit_app.py +337 -0
  86. package/.agents/skills/fastapi/SKILL.md +436 -0
  87. package/.agents/skills/fastapi/references/dependencies.md +142 -0
  88. package/.agents/skills/fastapi/references/other-tools.md +76 -0
  89. package/.agents/skills/fastapi/references/streaming.md +105 -0
  90. package/.agents/skills/frontend-design/LICENSE.txt +177 -0
  91. package/.agents/skills/frontend-design/SKILL.md +42 -0
  92. package/.agents/skills/gradio/SKILL.md +84 -0
  93. package/.agents/skills/gradio/references/api-signatures.md +115 -0
  94. package/.agents/skills/gradio/references/event-listeners.md +130 -0
  95. package/.agents/skills/gradio/references/examples.md +613 -0
  96. package/.agents/skills/ui-ux-pro-max/SKILL.md +659 -0
  97. package/.agents/skills/ui-ux-pro-max/data +1 -0
  98. package/.agents/skills/ui-ux-pro-max/scripts +1 -0
  99. package/.agents/stack.md +187 -187
  100. package/.env.axiom +8 -0
  101. package/AGENTS.md +2 -1
  102. package/README.md +19 -3
  103. package/bin/cli.js +11 -1
  104. package/opencode.json +12 -4
  105. package/package.json +1 -1
  106. package/skills-lock.json +36 -0
  107. package/.agents/skills/n8n-patterns/SKILL.md +0 -272
@@ -0,0 +1 @@
1
+ ../../../src/ui-ux-pro-max/data
@@ -0,0 +1 @@
1
+ ../../../src/ui-ux-pro-max/scripts
package/.agents/stack.md CHANGED
@@ -1,188 +1,188 @@
1
- # Tech Stack
2
-
3
- Current knowledge as of 2026. I know what's production-proven, what's hype, and what tradeoffs each choice carries.
4
-
5
- ---
6
-
7
- ## Languages
8
-
9
- | Language | Strength | When I Reach For It |
10
- |---|---|---|
11
- | **TypeScript** | Type safety, ecosystem, tooling | Frontend, Node backends, full-stack |
12
- | **Python** | ML/AI ecosystem, scripting, data | ML pipelines, APIs, automation |
13
- | **Go** | Performance, concurrency, simple deployment | High-throughput services, CLIs, platform tooling |
14
- | **Rust** | Memory safety, systems performance | Performance-critical components, WebAssembly targets |
15
- | **SQL** | Relational data, analytics | Anytime a relational DB is in the stack |
16
-
17
- ---
18
-
19
- ## Frontend
20
-
21
- ### Core
22
- - **React 19 / Next.js 15** — Default choice for production web apps; App Router, Server Components, streaming
23
- - **TypeScript** — Non-negotiable for any production frontend
24
- - **Tailwind CSS v4** — Utility-first; fast iteration; pairs well with component libraries
25
- - **shadcn/ui** — Accessible, unstyled-first components; copy-paste model beats black-box libs
26
-
27
- ### State & Data
28
- - **Zustand** — Lightweight client state; prefer over Redux for most apps
29
- - **TanStack Query (React Query v5)** — Server state, caching, background sync
30
- - **Zod** — Runtime schema validation; use at API boundaries and form inputs
31
-
32
- ### Testing
33
- - **Vitest** — Fast unit/integration testing; Vite-native
34
- - **Playwright** — E2E testing; cross-browser; better than Cypress for modern apps
35
- - **React Testing Library** — Component testing focused on user behavior, not internals
36
-
37
- ### Build / Tooling
38
- - **Vite** — Dev server and bundling for non-Next projects
39
- - **Biome** — Fast linter + formatter (replaces ESLint + Prettier in many setups)
40
- - **Turborepo** — Monorepo build orchestration
41
-
42
- ---
43
-
44
- ## Backend
45
-
46
- ### Node.js / TypeScript
47
- - **Hono** — Lightweight, edge-compatible, fast; preferred over Express for new projects
48
- - **Fastify** — High-performance Node HTTP framework when more features needed
49
- - **tRPC** — End-to-end type-safe APIs in full-stack TypeScript monorepos
50
- - **Prisma / Drizzle ORM** — Prisma for developer ergonomics; Drizzle for performance/edge
51
-
52
- ### Python
53
- - **FastAPI** — Default Python API framework; async, type-annotated, auto-docs
54
- - **Pydantic v2** — Data validation and settings management; use throughout
55
- - **SQLAlchemy 2.x** — ORM for complex relational data access
56
- - **uv** — Fast Python package manager; preferred over pip/poetry in 2026
57
- - **Ruff** — Python linter + formatter; replaces flake8, black, isort
58
-
59
- ### Authentication
60
- - **Clerk / Auth.js (NextAuth v5)** — For hosted auth in web apps
61
- - **JWT + refresh tokens** — For custom auth in API-first architectures
62
- - **OAuth 2.0 / OIDC** — Standard; know the flows, don't roll your own
63
-
64
- ---
65
-
66
- ## Databases
67
-
68
- ### Relational
69
- - **PostgreSQL** — Default relational database; battle-tested, extensions ecosystem
70
- - **Neon** — Serverless Postgres; preferred for projects needing scale-to-zero (avoids Supabase pausing)
71
- - **PlanetScale / Turso** — MySQL-compatible (PlanetScale) or SQLite-edge (Turso) alternatives
72
-
73
- ### Caching & Queues
74
- - **Redis / Valkey** — Caching, pub/sub, session storage, rate limiting
75
- - **BullMQ** — Job queue on top of Redis for Node.js
76
-
77
- ### Document / NoSQL
78
- - **MongoDB** — When document model genuinely fits; don't use as a schema-free escape hatch
79
- - **DynamoDB** — When you need AWS-native key-value at massive scale
80
-
81
- ### Vector Databases (AI workloads)
82
- - **pgvector** — Start here: Postgres extension for embeddings; zero new infra
83
- - **Pinecone** — Managed, production-grade; when pgvector hits limits
84
- - **Weaviate** — Self-hostable, good for hybrid search (keyword + semantic)
85
- - **Qdrant** — High-performance, Rust-native; strong for on-prem deployments
86
-
87
- ---
88
-
89
- ## AI / ML Stack
90
-
91
- ### LLM APIs & SDKs
92
- - **Anthropic Claude API** — claude-opus-4, claude-sonnet-4 (flagship reasoning and speed)
93
- - **OpenAI API** — GPT-4o, o3/o4-mini for reasoning tasks
94
- - **Google Gemini** — gemini-2.5-pro for long context and multimodal
95
- - **Vercel AI SDK** — Unified SDK for streaming, tool use, multi-provider support in JS/TS
96
- - **LiteLLM** — Provider-agnostic proxy; enables model switching without code changes
97
-
98
- ### Orchestration & Agents
99
- - **LangChain (LCEL v0.9+)** — Pipeline orchestration; use for composability
100
- - **LlamaIndex v1.2** — Knowledge retrieval layer; RAG pipelines, document parsing
101
- - **LangGraph** — Stateful multi-agent workflows; preferred for complex agent loops
102
- - **MCP (Model Context Protocol)** — De facto standard for agent ↔ tool connectivity; Anthropic-originated, now Linux Foundation; 97M monthly SDK downloads as of Feb 2026
103
-
104
- ### Embeddings & Retrieval
105
- - **text-embedding-3-large** (OpenAI) or **voyage-3** (Anthropic) — Production embedding models
106
- - **Hybrid search** — BM25 (keyword) + dense vector; almost always outperforms pure semantic
107
-
108
- ### Document Parsing (for RAG)
109
- - **Docling** — Strong structured doc parsing (PDF, DOCX, tables)
110
- - **MinerU** — PDF extraction with layout understanding
111
- - **Unstructured.io** — General-purpose document ingestion pipeline
112
-
113
- ### LLM Observability
114
- - **Langfuse** — Open-source LLM observability; traces, evals, cost tracking; self-hostable
115
- - **LangSmith** — LangChain-native tracing and eval platform
116
- - **OpenTelemetry** — Standard instrumentation; use for integrating LLM traces into existing observability stack
117
-
118
- ### MLOps / Training
119
- - **MLflow** — Experiment tracking, model registry, deployment; most widely adopted open-source
120
- - **Weights & Biases** — Richer experiment tracking for deep learning workflows
121
- - **Hugging Face Hub** — Model hosting, datasets, Spaces for demos
122
- - **Gradio** — Fastest path to an ML demo UI; pairs with HF Inference API
123
- - **PyTorch 2.x** — Default framework for ML model work; 55%+ production share
124
- - **vLLM** — High-throughput LLM inference server; PagedAttention; production serving
125
- - **Airflow / Prefect** — Pipeline orchestration for ML workflows; Airflow for proven stability, Prefect for modern DX
126
-
127
- ---
128
-
129
- ## Infrastructure & DevOps
130
-
131
- ### Containers & Orchestration
132
- - **Docker** — Standard containerization; multi-stage builds; use `uv` for Python images
133
- - **Kubernetes (K8s)** — Production orchestration at scale; know Deployments, Services, Ingress, HPA
134
- - **Docker Compose** — Local dev environments and simpler self-hosted production deployments
135
-
136
- ### Cloud Providers
137
- - **AWS** — Broadest services; ECS/EKS, Lambda, S3, RDS, SageMaker
138
- - **GCP** — Strong for ML/data workloads; Vertex AI, BigQuery, Cloud Run
139
- - **Azure** — Enterprise environments; Azure OpenAI for compliance-sensitive LLM use cases
140
- - **Vercel / Railway / Fly.io** — Deployment platforms for faster iteration cycles
141
-
142
- ### Infrastructure as Code
143
- - **Terraform** — Standard IaC; provider ecosystem; remote state in S3/GCS
144
- - **Pulumi** — IaC with real programming languages (TypeScript/Python) — good for complex infra logic
145
- - **CDK (AWS)** — AWS-native; prefer if already deep in AWS ecosystem
146
-
147
- ### CI/CD
148
- - **GitHub Actions** — Default choice; broad ecosystem; free for OSS
149
- - **GitLab CI** — When using GitLab; strong built-in container registry
150
- - Know: artifact caching, matrix builds, environment protection rules, OIDC for cloud auth (no long-lived secrets)
151
-
152
- ### Observability
153
- - **OpenTelemetry** — Vendor-neutral instrumentation standard; traces, metrics, logs
154
- - **Grafana + Prometheus** — Open-source metrics and dashboards; standard for self-hosted
155
- - **Datadog / New Relic** — Managed observability when budget allows; faster to set up
156
- - **Sentry** — Error tracking; essential for production frontend and backend
157
-
158
- ### Networking & Security
159
- - **Cloudflare** — CDN, DDoS protection, Workers for edge compute, Zero Trust
160
- - **Nginx / Caddy** — Reverse proxy; Caddy for automatic TLS
161
- - Secrets management: **Vault (HashiCorp)**, AWS Secrets Manager, or Doppler — never hardcode secrets, never commit `.env` to git
162
-
163
- ---
164
-
165
- ## Architectural Patterns I Know Well
166
-
167
- | Pattern | When It Fits |
168
- |---|---|
169
- | Monolith | Early-stage products; teams under ~8 engineers; fast iteration priority |
170
- | Modular Monolith | Monolith with clear internal boundaries; prepare for extraction later |
171
- | Microservices | Independent deployment needed; team ownership per service; clear domain boundaries |
172
- | Event-driven (Kafka/SQS) | Async processing; decoupled services; audit trails |
173
- | CQRS + Event Sourcing | Complex domains; full audit history required; high read/write asymmetry |
174
- | RAG Pipeline | LLM apps needing domain knowledge; reduces hallucination; more controllable than fine-tuning |
175
- | Agentic Loops (ReAct/MCP) | Multi-step autonomous tasks; tool use; planning required |
176
- | BFF (Backend for Frontend) | When frontend needs aggregated/transformed data; mobile vs. web diverge |
177
-
178
- ---
179
-
180
- ## What I Watch Out For (2026 Landscape)
181
-
182
- - **MCP adoption** is accelerating; evaluate it before building custom tool-integration layers
183
- - **pgvector first** for new RAG projects; only migrate to a dedicated vector DB when you hit real limits
184
- - **vLLM + self-hosted inference** is viable at mid-scale; evaluate against API costs at ~$500/month
185
- - **LangGraph > LangChain** for anything involving agent state, branching, or loops
186
- - **Biome over ESLint+Prettier** for new TS projects — same rules, 50–100x faster
187
- - **uv over pip/poetry** for Python projects — significantly faster, better lockfiles
1
+ # Tech Stack
2
+
3
+ Current knowledge as of 2026. I know what's production-proven, what's hype, and what tradeoffs each choice carries.
4
+
5
+ ---
6
+
7
+ ## Languages
8
+
9
+ | Language | Strength | When I Reach For It |
10
+ |---|---|---|
11
+ | **TypeScript** | Type safety, ecosystem, tooling | Frontend, Node backends, full-stack |
12
+ | **Python** | ML/AI ecosystem, scripting, data | ML pipelines, APIs, automation |
13
+ | **Go** | Performance, concurrency, simple deployment | High-throughput services, CLIs, platform tooling |
14
+ | **Rust** | Memory safety, systems performance | Performance-critical components, WebAssembly targets |
15
+ | **SQL** | Relational data, analytics | Anytime a relational DB is in the stack |
16
+
17
+ ---
18
+
19
+ ## Frontend
20
+
21
+ ### Core
22
+ - **React 19 / Next.js 15** — Default choice for production web apps; App Router, Server Components, streaming
23
+ - **TypeScript** — Non-negotiable for any production frontend
24
+ - **Tailwind CSS v4** — Utility-first; fast iteration; pairs well with component libraries
25
+ - **shadcn/ui** — Accessible, unstyled-first components; copy-paste model beats black-box libs
26
+
27
+ ### State & Data
28
+ - **Zustand** — Lightweight client state; prefer over Redux for most apps
29
+ - **TanStack Query (React Query v5)** — Server state, caching, background sync
30
+ - **Zod** — Runtime schema validation; use at API boundaries and form inputs
31
+
32
+ ### Testing
33
+ - **Vitest** — Fast unit/integration testing; Vite-native
34
+ - **Playwright** — E2E testing; cross-browser; better than Cypress for modern apps
35
+ - **React Testing Library** — Component testing focused on user behavior, not internals
36
+
37
+ ### Build / Tooling
38
+ - **Vite** — Dev server and bundling for non-Next projects
39
+ - **Biome** — Fast linter + formatter (replaces ESLint + Prettier in many setups)
40
+ - **Turborepo** — Monorepo build orchestration
41
+
42
+ ---
43
+
44
+ ## Backend
45
+
46
+ ### Node.js / TypeScript
47
+ - **Hono** — Lightweight, edge-compatible, fast; preferred over Express for new projects
48
+ - **Fastify** — High-performance Node HTTP framework when more features needed
49
+ - **tRPC** — End-to-end type-safe APIs in full-stack TypeScript monorepos
50
+ - **Prisma / Drizzle ORM** — Prisma for developer ergonomics; Drizzle for performance/edge
51
+
52
+ ### Python
53
+ - **FastAPI** — Default Python API framework; async, type-annotated, auto-docs
54
+ - **Pydantic v2** — Data validation and settings management; use throughout
55
+ - **SQLAlchemy 2.x** — ORM for complex relational data access
56
+ - **uv** — Fast Python package manager; preferred over pip/poetry in 2026
57
+ - **Ruff** — Python linter + formatter; replaces flake8, black, isort
58
+
59
+ ### Authentication
60
+ - **Clerk / Auth.js (NextAuth v5)** — For hosted auth in web apps
61
+ - **JWT + refresh tokens** — For custom auth in API-first architectures
62
+ - **OAuth 2.0 / OIDC** — Standard; know the flows, don't roll your own
63
+
64
+ ---
65
+
66
+ ## Databases
67
+
68
+ ### Relational
69
+ - **PostgreSQL** — Default relational database; battle-tested, extensions ecosystem
70
+ - **Neon** — Serverless Postgres; preferred for projects needing scale-to-zero (avoids Supabase pausing)
71
+ - **PlanetScale / Turso** — MySQL-compatible (PlanetScale) or SQLite-edge (Turso) alternatives
72
+
73
+ ### Caching & Queues
74
+ - **Redis / Valkey** — Caching, pub/sub, session storage, rate limiting
75
+ - **BullMQ** — Job queue on top of Redis for Node.js
76
+
77
+ ### Document / NoSQL
78
+ - **MongoDB** — When document model genuinely fits; don't use as a schema-free escape hatch
79
+ - **DynamoDB** — When you need AWS-native key-value at massive scale
80
+
81
+ ### Vector Databases (AI workloads)
82
+ - **pgvector** — Start here: Postgres extension for embeddings; zero new infra
83
+ - **Pinecone** — Managed, production-grade; when pgvector hits limits
84
+ - **Weaviate** — Self-hostable, good for hybrid search (keyword + semantic)
85
+ - **Qdrant** — High-performance, Rust-native; strong for on-prem deployments
86
+
87
+ ---
88
+
89
+ ## AI / ML Stack
90
+
91
+ ### LLM APIs & SDKs
92
+ - **Anthropic Claude API** — claude-opus-4, claude-sonnet-4 (flagship reasoning and speed)
93
+ - **OpenAI API** — GPT-4o, o3/o4-mini for reasoning tasks
94
+ - **Google Gemini** — gemini-2.5-pro for long context and multimodal
95
+ - **Vercel AI SDK** — Unified SDK for streaming, tool use, multi-provider support in JS/TS
96
+ - **LiteLLM** — Provider-agnostic proxy; enables model switching without code changes
97
+
98
+ ### Orchestration & Agents
99
+ - **LangChain (LCEL v0.9+)** — Pipeline orchestration; use for composability
100
+ - **LlamaIndex v1.2** — Knowledge retrieval layer; RAG pipelines, document parsing
101
+ - **LangGraph** — Stateful multi-agent workflows; preferred for complex agent loops
102
+ - **MCP (Model Context Protocol)** — De facto standard for agent ↔ tool connectivity; Anthropic-originated, now Linux Foundation; 97M monthly SDK downloads as of Feb 2026
103
+
104
+ ### Embeddings & Retrieval
105
+ - **text-embedding-3-large** (OpenAI) or **voyage-3** (Anthropic) — Production embedding models
106
+ - **Hybrid search** — BM25 (keyword) + dense vector; almost always outperforms pure semantic
107
+
108
+ ### Document Parsing (for RAG)
109
+ - **Docling** — Strong structured doc parsing (PDF, DOCX, tables)
110
+ - **MinerU** — PDF extraction with layout understanding
111
+ - **Unstructured.io** — General-purpose document ingestion pipeline
112
+
113
+ ### LLM Observability
114
+ - **Langfuse** — Open-source LLM observability; traces, evals, cost tracking; self-hostable
115
+ - **LangSmith** — LangChain-native tracing and eval platform
116
+ - **OpenTelemetry** — Standard instrumentation; use for integrating LLM traces into existing observability stack
117
+
118
+ ### MLOps / Training
119
+ - **MLflow** — Experiment tracking, model registry, deployment; most widely adopted open-source
120
+ - **Weights & Biases** — Richer experiment tracking for deep learning workflows
121
+ - **Hugging Face Hub** — Model hosting, datasets, Spaces for demos
122
+ - **Gradio** — Fastest path to an ML demo UI; pairs with HF Inference API
123
+ - **PyTorch 2.x** — Default framework for ML model work; 55%+ production share
124
+ - **vLLM** — High-throughput LLM inference server; PagedAttention; production serving
125
+ - **Airflow / Prefect** — Pipeline orchestration for ML workflows; Airflow for proven stability, Prefect for modern DX
126
+
127
+ ---
128
+
129
+ ## Infrastructure & DevOps
130
+
131
+ ### Containers & Orchestration
132
+ - **Docker** — Standard containerization; multi-stage builds; use `uv` for Python images
133
+ - **Kubernetes (K8s)** — Production orchestration at scale; know Deployments, Services, Ingress, HPA
134
+ - **Docker Compose** — Local dev environments and simpler self-hosted production deployments
135
+
136
+ ### Cloud Providers
137
+ - **AWS** — Broadest services; ECS/EKS, Lambda, S3, RDS, SageMaker
138
+ - **GCP** — Strong for ML/data workloads; Vertex AI, BigQuery, Cloud Run
139
+ - **Azure** — Enterprise environments; Azure OpenAI for compliance-sensitive LLM use cases
140
+ - **Vercel / Railway / Fly.io** — Deployment platforms for faster iteration cycles
141
+
142
+ ### Infrastructure as Code
143
+ - **Terraform** — Standard IaC; provider ecosystem; remote state in S3/GCS
144
+ - **Pulumi** — IaC with real programming languages (TypeScript/Python) — good for complex infra logic
145
+ - **CDK (AWS)** — AWS-native; prefer if already deep in AWS ecosystem
146
+
147
+ ### CI/CD
148
+ - **GitHub Actions** — Default choice; broad ecosystem; free for OSS
149
+ - **GitLab CI** — When using GitLab; strong built-in container registry
150
+ - Know: artifact caching, matrix builds, environment protection rules, OIDC for cloud auth (no long-lived secrets)
151
+
152
+ ### Observability
153
+ - **OpenTelemetry** — Vendor-neutral instrumentation standard; traces, metrics, logs
154
+ - **Grafana + Prometheus** — Open-source metrics and dashboards; standard for self-hosted
155
+ - **Datadog / New Relic** — Managed observability when budget allows; faster to set up
156
+ - **Sentry** — Error tracking; essential for production frontend and backend
157
+
158
+ ### Networking & Security
159
+ - **Cloudflare** — CDN, DDoS protection, Workers for edge compute, Zero Trust
160
+ - **Nginx / Caddy** — Reverse proxy; Caddy for automatic TLS
161
+ - Secrets management: **Vault (HashiCorp)**, AWS Secrets Manager, or Doppler — never hardcode secrets, never commit `.env` to git
162
+
163
+ ---
164
+
165
+ ## Architectural Patterns I Know Well
166
+
167
+ | Pattern | When It Fits |
168
+ |---|---|
169
+ | Monolith | Early-stage products; teams under ~8 engineers; fast iteration priority |
170
+ | Modular Monolith | Monolith with clear internal boundaries; prepare for extraction later |
171
+ | Microservices | Independent deployment needed; team ownership per service; clear domain boundaries |
172
+ | Event-driven (Kafka/SQS) | Async processing; decoupled services; audit trails |
173
+ | CQRS + Event Sourcing | Complex domains; full audit history required; high read/write asymmetry |
174
+ | RAG Pipeline | LLM apps needing domain knowledge; reduces hallucination; more controllable than fine-tuning |
175
+ | Agentic Loops (ReAct/MCP) | Multi-step autonomous tasks; tool use; planning required |
176
+ | BFF (Backend for Frontend) | When frontend needs aggregated/transformed data; mobile vs. web diverge |
177
+
178
+ ---
179
+
180
+ ## What I Watch Out For (2026 Landscape)
181
+
182
+ - **MCP adoption** is accelerating; evaluate it before building custom tool-integration layers
183
+ - **pgvector first** for new RAG projects; only migrate to a dedicated vector DB when you hit real limits
184
+ - **vLLM + self-hosted inference** is viable at mid-scale; evaluate against API costs at ~$500/month
185
+ - **LangGraph > LangChain** for anything involving agent state, branching, or loops
186
+ - **Biome over ESLint+Prettier** for new TS projects — same rules, 50–100x faster
187
+ - **uv over pip/poetry** for Python projects — significantly faster, better lockfiles
188
188
  - **Neon over Supabase** when inactivity pausing is a problem (portfolio projects, low-traffic apps)
package/.env.axiom ADDED
@@ -0,0 +1,8 @@
1
+ # npm security key for cikal
2
+ npm-security-key-cikal=your_npm_security_key_here
3
+
4
+ # MCP Server Credentials
5
+ N8N_MCP_TOKEN=your_n8n_mcp_token_here
6
+ NEON_API_KEY=your_neon_api_key_here
7
+
8
+ # Add other environment variables as needed
package/AGENTS.md CHANGED
@@ -36,4 +36,5 @@ I write code that survives contact with reality.
36
36
  - NEVER declare "it works" without verification
37
37
  - NEVER add dependencies without checking if built-ins suffice
38
38
  - NEVER over-engineer for a scale that doesn't exist yet
39
- - ALWAYS ask: "Does this solve the actual problem?"
39
+ - ALWAYS ask: "Does this solve the actual problem?"
40
+ - **ALWAYS reference the current date/time**: Today is {Month} {Year}. You search the current date in your operations and always remember that. When performing web searches or any time-sensitive queries, explicitly use the current year to avoid retrieving outdated results from previous years like 2024 or 2025.
package/README.md CHANGED
@@ -21,6 +21,8 @@ npx axiom-setup
21
21
  This command downloads the following files from the [axiom-coding-agent-setup](https://github.com/mcikalmerdeka/axiom-coding-agent-setup) repository into your current project directory:
22
22
 
23
23
  - `AGENTS.md` — Main agent instructions
24
+ - `opencode.json` — OpenCode IDE configuration (MCP servers, plugins)
25
+ - `.env.axiom` — Environment variables template for AXIOM credentials
24
26
  - `.agents/engineering.md` — Engineering principles & code standards
25
27
  - `.agents/stack.md` — Technology stack knowledge
26
28
  - `.agents/workflow.md` — Workflow guidelines & verification protocol
@@ -30,7 +32,13 @@ This command downloads the following files from the [axiom-coding-agent-setup](h
30
32
  ## Files Included
31
33
 
32
34
  ### AGENTS.md
33
- The main instruction file that coding agents (Claude, Cursor, etc.) read first when working on your project.
35
+ The main instruction file that coding agents (Claude, Cursor, OpenCode, etc.) read first when working on your project.
36
+
37
+ ### opencode.json
38
+ OpenCode IDE configuration including:
39
+ - MCP server definitions (remote tools like n8n, Neon, Gradio, etc.)
40
+ - Plugin configuration
41
+ - Environment variable references for secure credential management
34
42
 
35
43
  ### .agents/engineering.md
36
44
  Core engineering principles including:
@@ -64,10 +72,18 @@ Project-type specific convention files:
64
72
 
65
73
  ### .agents/skills/
66
74
  Domain-specific skills that can be loaded on-demand:
67
- - `mcp-builder/` — MCP server development guide
68
- - `n8n-patterns/` — n8n workflow automation patterns
75
+ - `agent-browser/` — Web browser automation skill
69
76
  - `ai-integration/` — LLM/AI integration patterns
70
77
  - `deployment-patterns/` — Deployment and infrastructure guide
78
+ - `developing-with-streamlit/` — Streamlit app development guides
79
+ - `fastapi/` — FastAPI best practices and patterns
80
+ - `fastapi-templates/` — FastAPI project templates
81
+ - `frontend-design/` — Frontend UI/UX design patterns
82
+ - `git-commit/` — Conventional commit message generation
83
+ - `gradio/` — Gradio UI framework guides
84
+ - `mcp-builder/` — MCP server development guide
85
+ - `n8n-patterns/` — n8n workflow automation patterns
86
+ - `ui-ux-pro-max/` — Advanced UI/UX design skill
71
87
 
72
88
  ## Development
73
89
 
package/bin/cli.js CHANGED
@@ -20,6 +20,8 @@ const FILES_TO_DOWNLOAD = [
20
20
  'AGENTS.md',
21
21
  // OpenCode configuration
22
22
  'opencode.json',
23
+ // Environment variables template
24
+ '.env.axiom',
23
25
  // Core agent documents
24
26
  '.agents/engineering.md',
25
27
  '.agents/stack.md',
@@ -28,12 +30,18 @@ const FILES_TO_DOWNLOAD = [
28
30
  '.agents/templates/ai-engineering-python.md',
29
31
  '.agents/templates/fullstack-ai-nextjs.md',
30
32
  // Skills (domain-specific guides)
33
+ '.agents/skills/agent-browser/SKILL.md',
31
34
  '.agents/skills/ai-integration/SKILL.md',
32
35
  '.agents/skills/deployment-patterns/SKILL.md',
36
+ '.agents/skills/developing-with-streamlit/SKILL.md',
37
+ '.agents/skills/fastapi/SKILL.md',
33
38
  '.agents/skills/fastapi-templates/SKILL.md',
39
+ '.agents/skills/frontend-design/SKILL.md',
34
40
  '.agents/skills/git-commit/SKILL.md',
41
+ '.agents/skills/gradio/SKILL.md',
35
42
  '.agents/skills/mcp-builder/SKILL.md',
36
- '.agents/skills/n8n-patterns/SKILL.md'
43
+ '.agents/skills/n8n-patterns/SKILL.md',
44
+ '.agents/skills/ui-ux-pro-max/SKILL.md'
37
45
  ];
38
46
 
39
47
  const GITHUB_RAW_URL = `https://raw.githubusercontent.com/${REPO_OWNER}/${REPO_NAME}/${BRANCH}`;
@@ -127,6 +135,8 @@ async function main() {
127
135
  if (successCount > 0) {
128
136
  log('Your project now has AXIOM coding agent instructions:', 'bold');
129
137
  log(' - AGENTS.md → Main agent instructions', 'cyan');
138
+ log(' - opencode.json → OpenCode IDE configuration', 'cyan');
139
+ log(' - .env.axiom → Environment variables template', 'cyan');
130
140
  log(' - .agents/engineering.md → Engineering principles', 'cyan');
131
141
  log(' - .agents/stack.md → Tech stack knowledge', 'cyan');
132
142
  log(' - .agents/workflow.md → Workflow guidelines', 'cyan');
package/opencode.json CHANGED
@@ -32,11 +32,14 @@
32
32
  "enabled": true,
33
33
  "headers": {}
34
34
  },
35
- "n8n-docs": {
35
+ "n8n-mcp": {
36
36
  "type": "remote",
37
- "url": "https://n8n.mcp.kapa.ai/",
37
+ "url": "http://localhost:5678/mcp-server/http",
38
38
  "enabled": true,
39
- "headers": {}
39
+ "headers": {
40
+ "Authorization": "Bearer {env:N8N_MCP_TOKEN}"
41
+ },
42
+ "oauth": false
40
43
  },
41
44
  "exa": {
42
45
  "type": "remote",
@@ -49,8 +52,13 @@
49
52
  "url": "https://mcp.neon.tech/mcp",
50
53
  "enabled": true,
51
54
  "headers": {
52
- "Authorization": "Bearer napi_8jp6kt4ci2ob5lz0jzgv5wivdov439h72if6hg4zqyy2w1krw8f0thwmzl0e5dpz"
55
+ "Authorization": "Bearer {env:NEON_API_KEY}"
53
56
  }
57
+ },
58
+ "eraser": {
59
+ "type": "remote",
60
+ "url": "https://app.eraser.io/api/mcp",
61
+ "enabled": true
54
62
  }
55
63
  }
56
64
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "axiom-coding-agent-setup",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "CLI tool to download AXIOM coding agent setup files into your project",
5
5
  "main": "bin/cli.js",
6
6
  "bin": {
package/skills-lock.json CHANGED
@@ -1,15 +1,51 @@
1
1
  {
2
2
  "version": 1,
3
3
  "skills": {
4
+ "agent-browser": {
5
+ "source": "vercel-labs/agent-browser",
6
+ "sourceType": "github",
7
+ "skillPath": "skills/agent-browser/SKILL.md",
8
+ "computedHash": "228f87d57035100d9dc6efcfc05aafd4b6e3962adacaa04b8217ab2fadb15dc8"
9
+ },
10
+ "developing-with-streamlit": {
11
+ "source": "streamlit/agent-skills",
12
+ "sourceType": "github",
13
+ "skillPath": "developing-with-streamlit/SKILL.md",
14
+ "computedHash": "51823384978f738f76ff8f601e11c1343aebea03d2ad782dc73fc22d3f129812"
15
+ },
16
+ "fastapi": {
17
+ "source": "fastapi/fastapi",
18
+ "sourceType": "github",
19
+ "skillPath": "fastapi/.agents/skills/fastapi/SKILL.md",
20
+ "computedHash": "9feb517089c269af4fdab5031dea1100a92fd50081e906ccfaf8a971858e39f9"
21
+ },
4
22
  "fastapi-templates": {
5
23
  "source": "wshobson/agents",
6
24
  "sourceType": "github",
7
25
  "computedHash": "1a5fe66bd2683afd1db9afdf37a25cd8b9195c369c98489333badf0406fc91b3"
8
26
  },
27
+ "frontend-design": {
28
+ "source": "anthropics/skills",
29
+ "sourceType": "github",
30
+ "skillPath": "skills/frontend-design/SKILL.md",
31
+ "computedHash": "516bd2154eb843a8240e43d5b285229129853114ad7075a5e141e1c08e408c84"
32
+ },
9
33
  "git-commit": {
10
34
  "source": "github/awesome-copilot",
11
35
  "sourceType": "github",
12
36
  "computedHash": "2607fc60629b82b257136dd2a7a373f0a4466c0b49df7746d845d59313c99b21"
37
+ },
38
+ "gradio": {
39
+ "source": "gradio-app/gradio",
40
+ "sourceType": "github",
41
+ "skillPath": ".agents/skills/gradio/SKILL.md",
42
+ "computedHash": "5078d8a4cc2b562731620f36f5f0d3ad054bd51f7a98baa547b04b893744823b"
43
+ },
44
+ "ui-ux-pro-max": {
45
+ "source": "nextlevelbuilder/ui-ux-pro-max-skill",
46
+ "sourceType": "github",
47
+ "skillPath": ".claude/skills/ui-ux-pro-max/SKILL.md",
48
+ "computedHash": "6337038fe1fe6bbe1b9f252ab678ee575859190bab6f0f246f4061824eb40875"
13
49
  }
14
50
  }
15
51
  }