Fix spelling, grammar, and formatting errors across docs

.claude/skills/add-new-skill/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: add-new-skill
+description: >
+  Creates a new skill by producing the agent-agnostic instruction file
+  (ai/skills/<name>.md) and the Claude Code entry point
+  (.claude/skills/<name>/SKILL.md) from canonical templates.
+  Registers the skill in CLAUDE.md, AGENTS.md, and ai/agent.md.
+  Use when adding a new repetitive task to the skills system.
+disable-model-invocation: true
+argument-hint: "[skill-name]"
+---
+
+Scaffolds a complete new skill: agent-agnostic instruction file with the
+required 4-section format, Claude Code SKILL.md with correct frontmatter,
+and registration in all three navigation files.
+
+For templates, rules, and DoD checklist, read `ai/skills/add-new-skill.md`.
+
+$ARGUMENTS

.claude/skills/cleanup-after-pipeline/SKILL.md

@@ -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.md`.
+
+$ARGUMENTS

.claude/skills/create-initiative-spec/SKILL.md

@@ -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.md`.
+
+$ARGUMENTS

.claude/skills/dev-ticket-pipeline/SKILL.md

@@ -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.md`.

.claude/skills/doc-review-pipeline/SKILL.md

@@ -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.md`.
+
+$ARGUMENTS

.claude/skills/generate-docs-from-spec/SKILL.md

@@ -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.md`.
+
+$ARGUMENTS

.claude/skills/promote-learnings/SKILL.md

@@ -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.md`.

.claude/skills/self-improvement/SKILL.md

@@ -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.md`.

.claude/skills/task-self-review/SKILL.md

@@ -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.md`.

.claude/skills/write-commit-message/SKILL.md

@@ -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.md`.
+
+## Current staged changes
+!`git diff --staged`
+
+## Recent commits (style reference)
+!`git log --oneline -10`

.dockerignore

@@ -0,0 +1,7 @@
+node_modules
+.git
+.gitignore
+ai/
+.kiro
+.DS_Store
+!README.md

.gitignore

@@ -0,0 +1,8 @@
+# AI pipeline working artifacts (page-slug subdirs only; README stays in repo)
+ai/outputs/review/*/
+
+# Dependencies
+node_modules/
+
+# macOS
+.DS_Store

.mintignore

@@ -0,0 +1,10 @@
+ai/
+.claude
+.github
+Dockerfile
+docker-compose.yml
+.dockerignore
+.gitignore
+.mintignore
+README.md
+CONTRIBUTING.md

AGENTS.md

@@ -0,0 +1,58 @@
+# 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.md` | On demand — processing a dev ticket |
+| Doc review pipeline | `ai/skills/doc-review-pipeline.md` | On demand — reviewing a doc page |
+| Generate docs from spec | `ai/skills/generate-docs-from-spec.md` | On demand — new MDX from spec |
+| Write commit message | `ai/skills/write-commit-message.md` | On demand — before committing |
+| Create initiative spec | `ai/skills/create-initiative-spec.md` | On demand — multi-phase work |
+| Cleanup after pipeline | `ai/skills/cleanup-after-pipeline.md` | On demand — after any pipeline |
+| Add new skill | `ai/skills/add-new-skill.md` | On demand — creating a new skill |
+| Task self-review | `ai/skills/task-self-review.md` | **Automatic** — after any task completion |
+| Self-improvement | `ai/skills/self-improvement.md` | **Automatic** — after any pipeline run |
+| Promote learnings | `ai/skills/promote-learnings.md` | **Automatic** — final step of self-improvement |
+
+## 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/prompts/` | Pipeline prompt files (inputs/outputs for AI tools) |
+| `ai/skills/` | Skill files — invocable task workflows with DoD checklists |
+| `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).