Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
113 commits
Select commit Hold shift + click to select a range
2b8af97
chore(ai): add skills layer, governance files, and Claude Code skills
whitebit-robot Mar 11, 2026
913a9bc
Merge pull request #43
whitebit-robot Mar 11, 2026
2853225
Merge pull request #44
whitebit-robot Mar 11, 2026
91c568c
fix(api): add missing mining pool rewards fields
whitebit-robot Mar 12, 2026
87c9de2
fix(api): add missing limit, offset fields to mining accounts list re…
whitebit-robot Mar 12, 2026
9f80843
Merge pull request #45
whitebit-robot Mar 12, 2026
33f74d1
fix(api): typo
whitebit-robot Mar 12, 2026
fc99fed
Merge pull request #46
whitebit-robot Mar 12, 2026
101c975
api(docs): change payoutDestination example in mining rewards response
whitebit-robot Mar 12, 2026
61946b7
Merge pull request #47
whitebit-robot Mar 12, 2026
28a4200
Merge pull request #48
whitebit-robot Mar 12, 2026
25a3ec2
added missing-schemas or validation
whitebit-robot Mar 18, 2026
d530c78
Merge pull request #49
whitebit-robot Mar 18, 2026
4d33ffc
docs(api): add kline, fix positions endpoint, remove cancel OCO/OTO p…
whitebit-robot Mar 20, 2026
380cc52
Fix transaction id field name
whitebit-robot Mar 20, 2026
1826cfb
Fix unique id field name
whitebit-robot Mar 20, 2026
d64cb70
Fix unique id field name
whitebit-robot Mar 20, 2026
8bdcf33
Fix transaction id field name
whitebit-robot Mar 20, 2026
a531ae4
Fix transaction id field name
whitebit-robot Mar 20, 2026
3469d52
Fix unique id field name
whitebit-robot Mar 20, 2026
bbd08e4
Merge pull request #51
whitebit-robot Mar 20, 2026
9712a44
Merge pull request #50
whitebit-robot Mar 20, 2026
2725b45
ocs(ai-hub): add AI Hub section with MCP server, CLI, and FAQ pages
whitebit-robot Mar 22, 2026
0ee9779
Merge pull request #53
whitebit-robot Mar 22, 2026
54415d1
Update guides/use-with-ai.mdx
whitebit-robot Mar 22, 2026
2768dee
fix(ai-context-menu): clarify MCP server name and fix duplicate link …
whitebit-robot Mar 22, 2026
5e7d340
Merge pull request #55
whitebit-robot Mar 22, 2026
f65a84e
Merge pull request #54
whitebit-robot Mar 22, 2026
aed6dc4
fix(api): restore mining pool rewards changes reverted by PR #49
whitebit-robot Mar 25, 2026
2c2fdc3
fix(api): restore and complete mining pool changes from PRs #41 #45 #…
whitebit-robot Mar 25, 2026
9c29923
Merge pull request #56
whitebit-robot Mar 25, 2026
1f4c758
feat(style): create 3 new skills for phase 1 of prompt migration
whitebit-robot Mar 25, 2026
b2da47e
feat(style): enrich existing skills with references/ — phase 2 of pro…
whitebit-robot Mar 26, 2026
2162092
feat(style): update orchestrator skills to invoke sub-skills — phase …
whitebit-robot Mar 26, 2026
0d75177
feat(style): complete prompt→skill migration
whitebit-robot Mar 26, 2026
a804079
feat(infra): add automated quality gates and pre-commit hooks
whitebit-robot Mar 26, 2026
45f7480
Update mirror.yml to strip .github/, .husky/, memory/ from public repo
whitebit-robot Mar 26, 2026
9003158
Tailscale step added as the first step
whitebit-robot Mar 26, 2026
688e453
chore: add package-lock.json for CI npm caching
whitebit-robot Mar 26, 2026
f2518e4
feat(style): add writer-review pre-pipeline skill
whitebit-robot Mar 26, 2026
6a6609e
CEX-5472: add payoutAddress & payoutTime to /api/v4/mining/rewards
whitebit-robot Mar 27, 2026
013e1d8
Merge pull request #57
whitebit-robot Mar 27, 2026
662853b
Merge branch 'stage' into feature/CEX-5472
whitebit-robot Mar 27, 2026
0ac2704
CEX-5472: group payout fields and fix payoutTime description in Minin…
whitebit-robot Mar 27, 2026
9999e32
Merge branch 'feature/CEX-5472' of github.com: into feature/CEX-5472
whitebit-robot Mar 27, 2026
5655fc7
Merge pull request #58
whitebit-robot Mar 27, 2026
e2a2f29
Merge pull request #59
whitebit-robot Mar 27, 2026
a638372
docs(api): expand pagination limit to 500 for history endpoints
whitebit-robot Mar 31, 2026
4265028
fix(api): correct descriptions and schemas across v4 specs
whitebit-robot Mar 31, 2026
5d1f62e
Merge pull request #60
whitebit-robot Mar 31, 2026
64999e9
Merge pull request #61
whitebit-robot Mar 31, 2026
6ad6b96
fix(api): correct descriptions and schemas across v4 specs
whitebit-robot Apr 1, 2026
bb6fe97
Merge pull request #62
whitebit-robot Apr 1, 2026
245052c
Merge pull request #63
whitebit-robot Apr 1, 2026
99f5f76
fix(api): expose all 3 auth headers in playground
whitebit-robot Apr 1, 2026
f54d023
chore(api): deprecate V1 and V2 API documentation
whitebit-robot Apr 1, 2026
d230e25
docs navigation updated;
whitebit-robot Apr 1, 2026
d651292
Merge pull request #64
whitebit-robot Apr 1, 2026
ebb1982
Merge remote-tracking branch 'origin/stage' into documentation/old-do…
whitebit-robot Apr 1, 2026
5f68415
Merge pull request #66
whitebit-robot Apr 1, 2026
c07359c
Mirroring pipline comment cleanuped
whitebit-robot Apr 1, 2026
90b70cc
Merge pull request #65
whitebit-robot Apr 1, 2026
1460130
Merge pull request #67
whitebit-robot Apr 1, 2026
bd40164
docs(market-data): add asset type classification note to asset status…
whitebit-robot Apr 1, 2026
9493dc4
Merge pull request #68
whitebit-robot Apr 1, 2026
6da7ec8
Merge pull request #69
whitebit-robot Apr 1, 2026
f006bd3
feat(websocket): add WsChannelOverview component and rebuild all WS c…
whitebit-robot Apr 1, 2026
8543f04
Merge pull request #70
whitebit-robot Apr 1, 2026
c5bad73
typo were fixed;
whitebit-robot Apr 2, 2026
7f81786
docs(api): add sub-account KYC URL endpoint
whitebit-robot Apr 2, 2026
04a2b0c
fix(api): clarify smart plans endpoint descriptions
whitebit-robot Apr 2, 2026
23e3ecb
feat(docs): add workers info to miner info, add reject rate to miner …
whitebit-robot Apr 2, 2026
be46307
Merge pull request #72
whitebit-robot Apr 2, 2026
07cdea2
Merge pull request #71
whitebit-robot Apr 2, 2026
0ed9428
custom component fix
whitebit-robot Apr 2, 2026
7b50952
Merge pull request #73
whitebit-robot Apr 2, 2026
dbbaa82
Merge pull request #74
whitebit-robot Apr 2, 2026
f416321
eat(websocket): migrate all 17 WS channel pages to custom component s…
whitebit-robot Apr 3, 2026
b9337ea
feat(style): add 5 skills and consolidate learnings into rules
whitebit-robot Apr 3, 2026
2622edd
fix(generate-ws-data): use actual export names in file header import …
whitebit-robot Apr 3, 2026
abe0e94
Merge pull request #75
whitebit-robot Apr 3, 2026
b837c12
template fixes
whitebit-robot Apr 3, 2026
ac5063a
Merge pull request #77
whitebit-robot Apr 3, 2026
4f3110b
Merge pull request #76
whitebit-robot Apr 3, 2026
6b8d83f
fix(websocket): close migration gaps and refactor AsyncAPI schemas fo…
whitebit-robot Apr 8, 2026
1f03e0b
Merge pull request #78
whitebit-robot Apr 8, 2026
cd74f8d
Merge pull request #79
whitebit-robot Apr 8, 2026
7f2346c
feat(websocket): auto-generate channel operations and tuple tables fr…
whitebit-robot Apr 8, 2026
ddfa77b
docs(ai): update style guide, template, and how-to for auto-generated…
whitebit-robot Apr 8, 2026
54891fc
Merge pull request #80
whitebit-robot Apr 8, 2026
6110848
fix(api): add defaults, pagination notes, and timestamp fixes to specs
whitebit-robot Apr 9, 2026
0bf98c2
feat(websocket): add WsErrorCodes component and componentize error co…
whitebit-robot Apr 9, 2026
6e04a3b
Merge pull request #81
whitebit-robot Apr 9, 2026
73d7c17
Merge pull request #82
whitebit-robot Apr 9, 2026
98599b1
feat(api): add RelatedResources component to render related links bel…
whitebit-robot Apr 9, 2026
a25041c
Merge pull request #84
whitebit-robot Apr 9, 2026
e80c4ce
fix(api): correct HTTP method for query-all-market-fees
whitebit-robot Apr 10, 2026
269f3de
feat(api): document response body for GET /api/v4/public/fee
whitebit-robot Apr 10, 2026
2c54dff
fix(api): resolve 6 audit findings and deduplicate order status schemas
whitebit-robot Apr 11, 2026
e8727b3
feat(style): consolidate learnings and promote retrospective findings
whitebit-robot Apr 12, 2026
3c37864
feat(docs): add rate limit components and RelatedResources to REST/WS…
whitebit-robot Apr 14, 2026
0067def
Merge pull request #86
whitebit-robot Apr 14, 2026
8c96217
default rate lmitis value was added
whitebit-robot Apr 14, 2026
51ed826
Merge pull request #87
whitebit-robot Apr 14, 2026
bb5b6ea
Merge pull request #88
whitebit-robot Apr 14, 2026
923be39
fix(ws): remove duplicate enum mapping from margin/borrow event_type …
whitebit-robot Apr 14, 2026
c358fa6
Merge pull request #89
whitebit-robot Apr 14, 2026
8f42992
Merge pull request #90
whitebit-robot Apr 14, 2026
b5fe248
docs(api): add reduceOnly parameter documentation for collateral orde…
whitebit-robot Apr 15, 2026
db4a189
docs updated
whitebit-robot Apr 15, 2026
49923e1
Merge pull request #91
whitebit-robot Apr 15, 2026
bf6903f
Merge pull request #92
whitebit-robot Apr 16, 2026
179b29c
fix: broken links in order-types page
mintlify[bot] Apr 20, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions .claude/skills/add-new-skill/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
name: add-new-skill
description: >
Superseded by skill-creator. Use /skill-creator for guided interactive
skill creation with validation and registration.
This stub is kept for backwards compatibility only.
disable-model-invocation: true
argument-hint: "[skill-name]"
---

This skill has been superseded by `skill-creator`, which provides guided
interactive skill creation with discovery, classification, build, validation,
and registration phases.

Use `/skill-creator` instead. For full instructions, read
`ai/skills/skill-creator/SKILL.md`.

$ARGUMENTS
20 changes: 20 additions & 0 deletions .claude/skills/cleanup-after-pipeline/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
name: cleanup-after-pipeline
description: >
Removes pasted content from ai/inputs/ files and deletes output artifacts
from ai/outputs/review/ after a pipeline run completes. Prevents stale
inputs from contaminating the next pipeline run.
Use after completing any dev-ticket or doc-review pipeline.
disable-model-invocation: true
argument-hint: "[dev-ticket|doc-review] [page-slug?]"
---

Cleans up pipeline inputs and outputs after a completed run. For dev-ticket:
clears ai/inputs/issue_description.md and ai/inputs/sme_answers.md. For
doc-review: also deletes ai/outputs/review/<page-slug>/ and clears
ai/inputs/review_target.md.

For full cleanup steps and confirmation requirements, read
`ai/skills/cleanup-after-pipeline/SKILL.md`.

$ARGUMENTS
19 changes: 19 additions & 0 deletions .claude/skills/create-initiative-spec/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
name: create-initiative-spec
description: >
Creates a structured initiative spec directory under ai/specs/<name>/ with
RULES.md, requirements.md, design.md, tasks.md, progress.md, and lessons.md.
Use only for multi-session work meeting the DD-6 threshold: 3+ phases,
8+ files, multiple doc domains, or multiple contributors.
disable-model-invocation: true
argument-hint: "[initiative-name]"
---

Creates a complete initiative spec following the docs portal spec format.
Only use when work meets the DD-6 threshold (see ai/RULES.md). For smaller
tasks, run the relevant pipeline skill directly.

For the spec structure, file templates, and DoD checklist, read
`ai/skills/create-initiative-spec/SKILL.md`.

$ARGUMENTS
16 changes: 16 additions & 0 deletions .claude/skills/dev-ticket-pipeline/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
name: dev-ticket-pipeline
description: >
Runs the 4-phase documentation update pipeline for a developer ticket.
Analyzes the ticket, generates clarification questions (Phase 2 gate),
builds an implementation plan, then executes all documentation changes.
Use when a developer ticket requires updates to the WhiteBIT portal docs.
disable-model-invocation: true
---

Orchestrates the complete documentation update workflow for a developer ticket:
ticket analysis → clarification questions → implementation plan → task execution →
task completion review → commit message. Stops at each pipeline gate for confirmation.

For full step-by-step instructions, gate rules, and DoD checklist, read
`ai/skills/dev-ticket-pipeline/SKILL.md`.
19 changes: 19 additions & 0 deletions .claude/skills/doc-review-pipeline/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
name: doc-review-pipeline
description: >
Runs the full documentation review pipeline for a portal page: style review,
findings challenge, implementation plan, task execution, and commit message.
Stops after challenge step for human confirmation before implementing fixes.
Use when reviewing a documentation page for style guide compliance.
disable-model-invocation: true
argument-hint: "[page-path]"
---

Orchestrates the complete doc review workflow: review → challenge → implementation
plan → task execution → task completion review → commit message → cleanup.
Stops at each pipeline gate for confirmation.

For full step-by-step instructions, gate rules, and DoD checklist, read
`ai/skills/doc-review-pipeline/SKILL.md`.

$ARGUMENTS
17 changes: 17 additions & 0 deletions .claude/skills/generate-docs-from-spec/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
name: generate-docs-from-spec
description: >
Generates a new MDX documentation page from an OpenAPI or AsyncAPI spec file.
Reads the spec, applies the api-endpoints or websocket style guide, and creates
the complete page in the correct portal directory.
Use when creating a new API reference page from a spec file.
disable-model-invocation: true
argument-hint: "[spec-file-path]"
---

Creates a new MDX page from an OpenAPI or AsyncAPI operation, following portal
conventions for file placement, navigation registration, and style guide compliance.

For full instructions and DoD checklist, read `ai/skills/generate-docs-from-spec/SKILL.md`.

$ARGUMENTS
15 changes: 15 additions & 0 deletions .claude/skills/promote-learnings/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
name: promote-learnings
description: >
Evaluates insights from the current pipeline or phase against the global
ai/LESSONS.md and ai/RULES.md to determine what should be promoted globally.
Runs as the final step of self-improvement. Never skip.
disable-model-invocation: true
---

Promotes locally captured lessons to the global knowledge base when they meet
the promotion threshold: universal governance rules go to ai/RULES.md; reusable
patterns go to ai/LESSONS.md; workflow gaps update the relevant skill file.

For the promotion decision tree and output format, read
`ai/skills/promote-learnings/SKILL.md`.
15 changes: 15 additions & 0 deletions .claude/skills/self-improvement/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
name: self-improvement
description: >
Evaluates the completed pipeline run for lessons, patterns, and workflow gaps.
Decides whether to write to ai/LESSONS.md (pattern-triggered) or the initiative
spec lessons.md (always, if spec exists). Then calls promote-learnings.
Run automatically after every completed pipeline. Never skip.
disable-model-invocation: true
---

Captures lessons from the current pipeline run. Always runs after any completed
pipeline. Writes to ai/LESSONS.md only when a pattern recurred ≥2 times or a
structural gap was found. Always writes to initiative lessons.md if a spec exists.

For the decision tree and output format, read `ai/skills/self-improvement/SKILL.md`.
20 changes: 20 additions & 0 deletions .claude/skills/skill-creator/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
name: skill-creator
description: >
Interactive guide for creating new Claude Code skills. Walks through use case
definition, frontmatter generation, instruction writing, supporting file creation,
and validation against the Agent Skills spec and Claude Code extensions.
Use when the user says "create a skill", "new skill", "build a skill", or
"I want to teach Claude to..."
disable-model-invocation: true
argument-hint: "[skill-name or description]"
---

Guides the user through 5 phases: Discovery (requirements), Classification (type
and invocation model), Build (frontmatter + instructions + supporting files),
Validation (spec compliance checklist), and Registration (CLAUDE.md + testing).

For the full creation pipeline, frontmatter rules, and validation checklist, read
`ai/skills/skill-creator/SKILL.md`.

$ARGUMENTS
18 changes: 18 additions & 0 deletions .claude/skills/skill-reviewer/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
name: skill-reviewer
description: >
Review and audit Claude Code skills against the Agent Skills spec and Claude Code docs.
Evaluates frontmatter compliance, invocation model, description quality, progressive
disclosure, instruction effectiveness, and workflow placement. Use when the user says
"review skill", "audit skill", "check my skill", or "where does this skill fit?"
disable-model-invocation: true
argument-hint: "[skill-name or path-to-SKILL.md]"
---

Runs in two modes: Review Mode (quality audit against the Agent Skills spec — structural
compliance, description, invocation model, progressive disclosure, composability) and
Placement Mode (workflow taxonomy and pipeline integration for this project).

For the full review criteria and report format, read `ai/skills/skill-reviewer/SKILL.md`.

$ARGUMENTS
14 changes: 14 additions & 0 deletions .claude/skills/task-self-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
name: task-self-review
description: >
Performs a quick quality check on a just-completed documentation task before
marking it done. Verifies DoD compliance, checks for duplication, validates
style guide adherence, and confirms no files outside scope were modified.
Run automatically after completing any documentation task.
disable-model-invocation: true
---

Lightweight, focused quality check on the most recently completed task.
Faster than `task-completion-review` — covers DoD checklist and scope discipline only.

For the review checklist and output format, read `ai/skills/task-self-review/SKILL.md`.
21 changes: 21 additions & 0 deletions .claude/skills/write-commit-message/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
name: write-commit-message
description: >
Generates a conventional commit message by analyzing staged git changes and
recent commit history to match the project's commit style. Presents the message
for user approval — never commits automatically.
Use when staging changes for commit or when asked to generate a commit message.
disable-model-invocation: true
---

Generates a conventional commit message following the `docs:`, `fix:`, `feat:`,
or `chore:` format with scope. Presents the message to the user for approval.
Never performs `git commit` — that is the user's responsibility.

For full instructions and format rules, read `ai/skills/write-commit-message/SKILL.md`.

## Current staged changes
!`git diff --staged`

## Recent commits (style reference)
!`git log --oneline -10`
4 changes: 4 additions & 0 deletions .mintignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
ai/
scripts/
.claude
.github
.husky
Dockerfile
docker-compose.yml
.dockerignore
Expand Down
73 changes: 73 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# WhiteBIT Documentation Portal — AI Agent Reference

> Entry point for non-Claude AI agents (Kiro, Cursor, and others).
> For Claude Code, see `CLAUDE.md`. For binding rules, read `ai/RULES.md`.

## Project

Mintlify documentation portal for the WhiteBIT cryptocurrency exchange. Covers REST API
(v1/v2/v4), WebSocket API, OAuth, platform guides, user guides, FAQ, changelog, and
glossary. Read `ai/agent.md` for the full portal structure, file conventions, and content
map.

## First — Read the Rules

Load `ai/RULES.md` before starting any task. It contains:
- §1 AI Behavior — critical thinking, clarification requirements, discussion protocol
- §2 Pipeline Governance — pipeline gates, commit protocol, validation
- §3 Content Rules — style guides, fabrication prohibition, navigation
- §4 Self-Improvement — when to run, when to write to LESSONS.md

## Skills

Load the relevant skill file and follow its steps and DoD checklist.
Automatic skills run after every pipeline without being explicitly asked.

| Skill | File | When |
|-------|------|------|
| Dev ticket pipeline | `ai/skills/dev-ticket-pipeline/SKILL.md` | On demand — processing a dev ticket |
| Ticket analysis | `ai/skills/ticket-analysis/SKILL.md` | internal — invoked by dev-ticket-pipeline (Phases 1–2) |
| Ticket impl plan | `ai/skills/ticket-impl-plan/SKILL.md` | internal — invoked by dev-ticket-pipeline (Phases 3–4) |
| Doc review pipeline | `ai/skills/doc-review-pipeline/SKILL.md` | On demand — reviewing a doc page |
| Doc style review | `ai/skills/doc-style-review/SKILL.md` | internal — invoked by doc-review-pipeline (Phases 1–2) |
| Doc review plan | `ai/skills/doc-review-plan/SKILL.md` | internal — invoked by doc-review-pipeline (Phases 3–4) |
| Integration check | `ai/skills/integration-check/SKILL.md` | internal — invoked by ticket-impl-plan and doc-review-plan |
| Task execution | `ai/skills/task-execution/SKILL.md` | internal — invoked by dev-ticket-pipeline and doc-review-pipeline (Phase 5) |
| Task completion review | `ai/skills/task-completion-review/SKILL.md` | On demand — before committing; invoked by pipelines at Phase 6 |
| Generate docs from spec | `ai/skills/generate-docs-from-spec/SKILL.md` | On demand — new MDX from spec |
| Write commit message | `ai/skills/write-commit-message/SKILL.md` | On demand — before committing |
| Create initiative spec | `ai/skills/create-initiative-spec/SKILL.md` | On demand — multi-phase work |
| Cleanup after pipeline | `ai/skills/cleanup-after-pipeline/SKILL.md` | On demand — after any pipeline |
| Create skill (interactive) | `ai/skills/skill-creator/SKILL.md` | On demand — guided skill creation with validation |
| Review skill | `ai/skills/skill-reviewer/SKILL.md` | On demand — audit a skill for quality and workflow fit |
| Task self-review | `ai/skills/task-self-review/SKILL.md` | **Automatic** — after any task completion |
| Self-improvement | `ai/skills/self-improvement/SKILL.md` | **Automatic** — after any pipeline run |
| Promote learnings | `ai/skills/promote-learnings/SKILL.md` | **Automatic** — final step of self-improvement |
| Plan review | `ai/skills/plan-review/SKILL.md` | **Automatic** — after implementation plan generated (Phase 3) |
| Task learnings | `ai/skills/task-learnings/SKILL.md` | **Automatic** — called by self-improvement for extraction |
| Learning consolidator | `ai/skills/learning-consolidator/SKILL.md` | On demand — ~weekly cleanup of ai/LESSONS.md |
| Answer partner questions | `ai/skills/answer-partner-questions/SKILL.md` | On demand — researching API capabilities for partner/client questions |
| Session retrospective | `ai/skills/session-retrospective/SKILL.md` | On demand — cross-session pattern analysis; use after a period of work |
| AI changelog | `ai/skills/ai-changelog/SKILL.md` | internal — called after AI infrastructure changes by skill-creator, task-learnings, learning-consolidator |
| AI improvement tracker | `ai/skills/ai-improvement-tracker/SKILL.md` | internal — called after ai-changelog to record testable improvement hypotheses |
| Docker local rebuild | `ai/skills/docker-local-rebuild/SKILL.md` | On demand — rebuild and start the portal in Docker for local testing |

## Key Files

| File | Purpose |
|------|---------|
| `ai/RULES.md` | All binding rules for AI work on this portal |
| `ai/LESSONS.md` | Accumulated lessons (pattern-triggered entries) |
| `ai/agent.md` | Portal structure, file conventions, content map |
| `ai/skills/` | All invocable skills — entry points, orchestration, references/ content |
| `ai/style-guides/` | Writing conventions (use README.md decision tree to pick one) |
| `docs.json` | Navigation configuration — update when adding pages |

## Behavioral Expectations

These rules apply regardless of which AI agent is in use. Full rules are in `ai/RULES.md`.

- Do not blindly agree. Flag errors and bad assumptions with evidence (§1.1).
- Ask clarifying questions before starting ambiguous tasks — batch all questions at once (§1.2).
- Never run `git commit` autonomously. Generate the message; the human commits (§2.2).
- After any pipeline: run self-improvement, then promote-learnings (§4.1).
Loading