[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M755EKGJEC3AXNZJ1T1C6582":3,"skill-same:01M755EKGJEC3AXNZJ1T1C6582":64},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M755EKGJEC3AXNZJ1T1C6582","manifest",null,"Use when starting a non-trivial feature, migration, refactor, or multi-step task in ANY repo. Creates and continuously maintains a living markdown manifest at `\u003Crepo-root>\u002Ftasks\u002F\u003Cslug>\u002Fmanifest.md` (inside the repo being worked on — NEVER the skill dir or ~\u002F) capturing the problem, decisions, exploration results, plan, open questions, test + rollout plans, and final review. Trigger on \"build X\", \"add X\", \"migrate X\", \"refactor X\", tasks needing 3+ steps, or whenever a plan-before-code loop would help. NOT for single-line fixes, obvious bugs, or one-shot questions.","auth-02\u002Fhub","auth-02","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F146264364?v=4","01M755DW6DVATA25MM8323VK52","Atharva Shinde","01M755DW7CDZNCA30JT6VP7MQ5",3,"MIT","https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fmanifest\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: manifest\ndescription: Use when starting a non-trivial feature, migration, refactor, or multi-step task in ANY repo. Creates and continuously maintains a living markdown manifest at `\u003Crepo-root>\u002Ftasks\u002F\u003Cslug>\u002Fmanifest.md` (inside the repo being worked on — NEVER the skill dir or ~\u002F) capturing the problem, decisions, exploration results, plan, open questions, test + rollout plans, and final review. Trigger on \"build X\", \"add X\", \"migrate X\", \"refactor X\", tasks needing 3+ steps, or whenever a plan-before-code loop would help. NOT for single-line fixes, obvious bugs, or one-shot questions.\n---\n\n# manifest\n\nEvery feature gets a **manifest** — a living markdown doc that declares the problem, the plan, the findings, and the eventual outcome. It lives inside the repo you are working on, right next to the code, so reviewers and future sessions read it alongside the diff. The deliverable is not just the code — it is the manifest that explains what\u002Fwhy\u002Fhow.\n\n## Where the manifest lives\n\n**Always inside the repo being worked on**, at `\u003Crepo-root>\u002Ftasks\u002F\u003Cslug>\u002Fmanifest.md`. Resolve `\u003Crepo-root>` from the current working directory: the nearest ancestor that is a repo root (contains `.git` \u002F `pyproject.toml` \u002F `package.json` \u002F similar). In a multi-repo workspace, that is the specific repo the work belongs to — not the workspace root above it.\n\n**Never** write to:\n- The workspace root above any repo. Manifest-collection tooling scans each repo's `tasks\u002F`, so a manifest placed above a repo would be invisible.\n- The skills directory (`~\u002Fskills`) or the skill directory itself.\n- Anywhere outside a repo.\n\nIf the current working directory is a multi-repo workspace root (not inside a specific repo) and the user hasn't named a target repo, **ask which repo this work belongs to** before creating the file. Don't guess.\n\n**Why this matters:** tooling that collects manifest docs looks for `manifest.md` files under each repo's `tasks\u002F**\u002Fmanifest.md`. A manifest in the wrong location (or named anything other than `manifest.md`) won't be picked up, defeating the proactive-update workflow below.\n\nCreate the `tasks\u002F` directory if it does not exist. **Every task gets its own subfolder.** At init, create **only** `tasks\u002F\u003Cslug>\u002Fmanifest.md` — do **not** pre-create `data\u002F`, `artifacts\u002F`, or `runs\u002F` upfront. Each subdir is created **lazily, only when something actually needs to go in it** (the first data file → `data\u002F`, the first probe note\u002Fscript → `artifacts\u002F`, the first validation run → `runs\u002F\u003Cdate>\u002F`). Empty scaffolding directories are noise; a fresh task is just its `manifest.md`.\n\n```\n\u003Crepo-root>\u002Ftasks\u002F\n└── \u003Cslug>\u002F\n    ├── manifest.md      # the living manifest          (template: templates\u002Fmanifest.md)\n    ├── data\u002F            # referenced\u002Fsource inputs only: PDFs, Excel, CSVs, datasets, JSON\n    ├── artifacts\u002F       # inspection notes, scripts,   (template: templates\u002Finspection.md)\n    │                    # probe outputs\n    └── runs\u002F            # dated outputs from actual test\u002Fvalidation runs\n        └── YYYY-MM-DD\u002F  # one folder per run date; SSE logs, tables, run CSVs go here\n```\n\nRules:\n- The manifest is always named **`manifest.md`** (never `\u003Cslug>.md`) — this makes it predictable for tooling (standup collection, grep).\n- **`data\u002F`** holds **referenced \u002F source inputs only** — files given to or consumed by the task (example workbooks, sample PDFs\u002FExcel\u002FCSVs, datasets, JSON inputs). Create it on demand when such a file first enters the task (subfolders OK, e.g. `data\u002Fresults\u002F`). Keep generated virtualenvs, `node_modules`, and caches **out** of the task tree entirely.\n- **`artifacts\u002F`** holds **everything I generate** — inspection notes, one-off scripts\u002Fprobes, AND generated output deliverables (PDFs, guides, derived spreadsheets). Generated files are **never** put in `data\u002F`; if I produced it, it goes here (dated run outputs go in `runs\u002F`).\n- **`runs\u002F`** holds time-stamped outputs from actually firing queries or running validation: SSE logs, parsed tables, benchmark results. One subfolder per date (`YYYY-MM-DD\u002F`). Run outputs stay under their dated folder — they are not moved into `data\u002F`.\n- Never put inspection files, data files, or run outputs at the `tasks\u002F\u003Cslug>\u002F` root — keep the root clean (just `manifest.md` + the subdirs).\n\nCopy from `~\u002Fskills\u002Fmanifest\u002Ftemplates\u002F\u003Cname>.md` when creating the manifest — fill in the title, ask, and any decisions already captured, then leave the rest as placeholders.\n\nSlug: lowercase, hyphenated, imperative (`ndjson-to-parquet-migration`, `add-sso-login`, `refactor-payment-flow`).\n\nThe `tasks\u002F` directory is **gitignored** — manifests, their `data\u002F`, `artifacts\u002F`, and `runs\u002F` are **local-only** and never committed or pushed. Don't try to `git add` them. (When setting up a brand-new repo, add `tasks\u002F` to its `.gitignore` first.)\n\n## Core principle\n\n**Write the manifest before the code, then keep it honest.** Every user answer, every surprise from exploration, every change of plan lands in the manifest in the same session. If the manifest drifts from reality, the workflow has failed.\n\n## When to trigger\n\nInvoke at the **start** of:\n\n- A feature build (e.g. \"add X\", \"support Y\", \"integrate with Z\").\n- A migration (format, schema, dependency, infrastructure).\n- A refactor touching 3+ files.\n- Anything where the user says \"plan\" \u002F \"first figure out\" \u002F \"explore\" \u002F \"let's design\".\n- Any task requiring exploration before implementation is sensible.\n\nSkip for: typo fixes, single-line bug fixes, renames, answering a question, trivial one-shot edits.\n\n## The manifest structure\n\nUse these sections in this order. Sections can be empty with placeholder text; don't skip them.\n\n```markdown\n# \u003CFeature \u002F Task Title>\n\n## Context\nOne paragraph on the ask as you understood it from the user, plus any business or technical background. Not the plan — the problem.\n\n### Decisions\nNumbered list of decisions the user has already made (or made during the session). Each line should stand alone.\n1. \u003Cdecision> — captured \u003Cdate or \"from session\">.\n2. ...\n\n## Exploration Results\nWhat you found in the codebase. Cross-link `file:line` for every claim. Sections suggested (adapt as needed):\n### Consumers \u002F callers\n### Data shape \u002F schema\n### Related subsystems\n### Out of scope\n### Not found\n(Keep this section factual. No plan verbs like \"we will\" or \"let's\".)\n\n## Plan\nCheckbox list of steps. Each step: one line heading + a few sub-bullets describing the edit. Update checkbox state (`[x]`) as you go.\n\n- [ ] **Step 1 — \u003Cname>** `\u003Cpath\u002Fto\u002Ffile>`\n  - What to change\n  - Why \u002F what it unblocks\n\n## Open questions\nNumbered list. When the user answers, append `-> \u003Canswer>` inline on the same line; do not delete the question.\n1. \u003Cquestion>?\n2. \u003Cquestion>? -> \u003Cuser's answer, captured inline>\n\n## Confirmed findings (after real exploration)\nPopulate AFTER running exploration code \u002F probes. Distinguish \"assumed\" from \"confirmed\". Includes:\n- Tables of concrete observations (blob names, schemas, counts).\n- Callouts for surprises that invalidate the initial plan — use ⚠️.\n\n## Testing plan\nConcrete steps. Day-by-day if multi-day. Include: parity baselines, canary, fallback tests, scheduled runs, exit gate.\n\n## Rollout plan\nStages, rollback procedure, coordination notes, gotchas.\n\n## Review\nFill in at the end. Files changed (with one-line per-file summary), how to cut over, known follow-ups, what was flagged out-of-scope.\n```\n\n## Workflow stages\n\n### 1. Capture the ask (before any tool calls other than creating the manifest)\n\n- Read the user's message carefully. Paraphrase the problem back in one sentence before doing anything.\n- Create `tasks\u002F\u003Cslug>\u002Fmanifest.md` populated from the ask — and nothing else; `data\u002F`, `artifacts\u002F`, `runs\u002F` come lazily per the rule above. \"Exploration Results\" and \"Confirmed findings\" are empty placeholders. \"Plan\" has rough shape only — don't overcommit before exploring.\n- If the user gave a spec\u002Flist\u002Ftable, paste it verbatim under **Context** so it's not lost.\n- **After creating the manifest**, write the slug to `tasks\u002F.current-task` (one line, no newline padding) so the shell prompt can display it: `echo -n \"\u003Cslug>\" > tasks\u002F.current-task`. This file is the prompt's source of truth — update it whenever the active task changes mid-session (e.g. user switches to a different task on the same branch).\n\n### 2. Explore\n\n- Use grep \u002F read \u002F file-listing to find consumers, patterns, and current behaviour. Delegate to subagents (Explore \u002F general-purpose) for broad sweeps. Limit direct reads to files you've identified.\n- Write findings to **Exploration Results** as you go — `file:line` references, not summaries.\n- For anything that requires real-world data (bucket contents, DB schema, external API shape), write a **read-only** probe script\u002Fasset\u002Fquery, run it, and save the output under `artifacts\u002F` (e.g. `artifacts\u002Finspection.md`, `artifacts\u002F\u003Cprobe>.csv`). Never guess what remote state looks like.\n- Flag surprises immediately in **Confirmed findings** with ⚠️ — e.g. \"field X is dropped from the new schema\", \"file is unsharded where docs said sharded\".\n\n### 3. Plan + open questions\n\n- Convert exploration into a step-by-step **Plan** with checkboxes. Keep each step minimal — bug fix-sized if possible.\n- Extract decisions the user must make into **Open questions**. Ask them all at once, numbered, so the user can answer inline.\n- When the user answers, edit the manifest: append `-> \u003Canswer>` to each question. Then merge the answer into **Decisions**.\n\n### 4. Implement\n\n- Update the plan's checkboxes as steps complete. Don't batch — mark each done when it's actually done.\n- When a step reveals something unexpected (a missing field, a broken assumption), stop, update **Confirmed findings**, update the plan if scope changed, then continue.\n- For risky writes (DBs, buckets, external systems shared with other envs), design a **local\u002Fdev-only gate** (e.g. a `local_csv_output_dir` config, a `dry_run` flag, a `dev_only` toggle) — then document it in a dedicated subsection of the manifest.\n\n### 5. Tests + rollout\n\n- Write a **Testing plan** with explicit parity baselines (\"diff row counts vs main\"), canary (one asset \u002F one file at a time), fallback verification, and an exit gate.\n- Write a **Rollout plan** with stages, a rollback procedure (ideally config-only, no redeploy), and coordination notes (who needs to know before flipping production).\n- If the user has constraints like \"don't touch demo\", \"dev only\", \"keep fallback\" — surface them at the top of the rollout plan.\n\n### 6. Finalize\n\n- Populate the **Review** section: files changed (with a one-line summary each), how to cut over, follow-ups, out-of-scope items.\n- Offer the next natural step (branch + push + MR, schedule a cleanup agent, etc.) but don't take destructive\u002Fshared actions without confirmation.\n- On `git commit` \u002F branch creation: the commit message should mirror the Review summary. Keep the manifest out of the commit if it's gitignored — otherwise include it.\n\n## Operating rules\n\n- **One manifest per task.** Don't create tiers\u002Fsub-docs unless the user asks for it.\n- **Append-only for decisions and open questions.** Never delete history; strike-through or annotate if a decision reverses.\n- **Real data over assumptions.** If the manifest makes a schema claim, it must be backed by a probe saved alongside.\n- **Update in the same session.** Don't defer updates with \"I'll record this later\".\n- **Cross-link everything.** `file:line` for code claims; relative paths to inspection files; commit SHAs in the Review.\n- **Defer code until the plan is agreed.** If the user hasn't confirmed direction, don't start edits — unless they explicitly said \"just do it\".\n- **Protect shared infra.** When the work touches DBs, buckets, queues, or external services used by demo\u002Fprod, add an isolation knob early and document it.\n- **Never invent skill \u002F subagent \u002F tool names.** Only use ones that exist in the environment.\n\n## Proactive updating — do this without being asked\n\nUpdating the manifest is **part of the task**, not an extra chore the user has to request. Once a manifest exists for the current work, treat every one of the events below as an automatic trigger to edit it in the **same turn** the event happens — before moving on, before the next reply, before running more tools. The user should never have to say \"write this down\" \u002F \"log the decision\" \u002F \"update the task file\".\n\nTriggers that automatically update the manifest (in the same turn):\n\n1. **User answers an Open Question** → append `-> \u003Canswer>` inline on that question, then promote the answer to **Decisions** (numbered, dated).\n2. **User reverses or refines an earlier decision** → strike-through the old decision, add the new one with a date and a `Superseded (YYYY-MM-DD)` tag; never delete the old line.\n3. **User approves a course of action** (\"ok\", \"do it\", \"that's fine\", \"whatever you choose\") → record the concrete choice that was on the table as a Decision before executing.\n4. **Exploration reveals something that invalidates the plan** → add a ⚠️ entry to **Confirmed findings** and update the affected Plan step, in the same turn.\n5. **A plan step completes** → flip its checkbox `[ ]` → `[x]` immediately; if the step split into sub-steps, list them inline.\n6. **New scope added mid-session** → either add a new Plan step or (for a genuinely separate task) spin up a second manifest file; do not silently grow an existing step.\n7. **A follow-up iteration after \"Review\"** (user asks for a tweak after you declared done) → add a **Follow-up increments** subsection under Review with what changed and why, in the same turn. Don't reopen the main Plan unless the change is large.\n8. **Files are edited, created, or deleted** → update **Files changed** in Review the same turn (don't wait until the user asks for a summary).\n9. **`gitignore` \u002F `tasks\u002F` visibility** → if `tasks\u002F` is not in `.gitignore`, note it; if the user wants it local, add it to `.gitignore` without asking again after the first confirmation.\n\nRule of thumb: if you're about to say something in chat that is a **decision, a finding, a change, or a reversal**, the manifest gets the same content first (or at the latest, in the same turn). Chat is ephemeral; the manifest is the record.\n\nWhen you can't tell whether something warrants a manifest update, err toward writing it down — a slightly over-documented manifest costs nothing; a silently-drifted one costs trust.\n\n## Anti-patterns to avoid\n\n- Writing a grand plan before any exploration. Plans written without grepping are fiction.\n- Letting the manifest and the code diverge. If you updated code, update the manifest in the same turn.\n- Mixing \"the ask\" and \"the plan\" in one section. Separate what the user wanted from what you intend to do.\n- Dropping the fallback \u002F rollback section because \"we won't need it\". Keep it — future-you will.\n- Hiding surprises. If exploration invalidates a decision, say so with ⚠️ and update **Decisions** with the revised stance.\n- Committing the manifest without checking gitignore.\n- Narrating every step in chat while the manifest stays sparse. The chat is ephemeral; the manifest is the record.\n- **Waiting to be told, batching updates, or leaving reversed decisions undocumented** — all violations of **Proactive updating** above: update in the same turn, unprompted, keeping superseded decisions struck-through with a date.\n\n## Templates\n\nCopy from `~\u002Fskills\u002Fmanifest\u002Ftemplates\u002F` — but only when each is actually needed (see the lazy-creation rule above), not all upfront:\n\n- `manifest.md` — the main manifest scaffold (Context, Decisions, Exploration Results, Plan, Open questions, Confirmed findings, Testing plan, Rollout plan, Review). Copied **at init** — lands at `tasks\u002F\u003Cslug>\u002Fmanifest.md`.\n- `inspection.md` — for raw exploration probes. Copied **only when you start probing** — lands at `tasks\u002F\u003Cslug>\u002Fartifacts\u002Finspection.md` (creating `artifacts\u002F` then).\n- `notes.md` — free-form scratch. Copied **only when you need it** — lands at `tasks\u002F\u003Cslug>\u002Fartifacts\u002Fnotes.md`.\n\nFor the manifest, fill in the title and any context you already have from the user's ask, then keep the other sections as placeholders to populate as the work progresses.\n\n## Example invocations\n\n- \"Let's add support for parquet in the pipeline\" → create `tasks\u002Fadd-parquet-support\u002Fmanifest.md`, start at stage 1.\n- \"Refactor the auth middleware to use JWT\" → create `tasks\u002Frefactor-auth-to-jwt\u002Fmanifest.md`.\n- \"Migrate sector_exposure to a normalized table\" → create `tasks\u002Fnormalize-sector-exposure\u002Fmanifest.md`.\n- \"Integrate with Acme Payments\" → create `tasks\u002Fintegrate-acme-payments\u002Fmanifest.md`.\n\n## Example\n\n`examples\u002Fmigrate-uploads-to-object-storage.md` is a comprehensive manifest to model yours on: a design-first migration showing a full Context paragraph, a numbered Decisions log (with dates), exploration findings with `file:line` cross-links, a Stack section, a per-layer Plan, testing + rollout plans, and the Review placeholder. Use it to calibrate altitude and how much to capture at each stage.\n\n## Not for\n\n- \"Fix the typo on line 12\" — too small.\n- \"Why is this function slow?\" — it's a question, not a feature.\n- \"Rename `foo` to `bar` across the repo\" — rename, no design surface.\n- Multi-turn conversations where the user has already started implementing without a plan and just wants help finishing — if the manifest would be retrofit, ask first.\n","# manifest\n\nEvery feature gets a **manifest** — a living markdown doc that declares the problem, the plan, the findings, and the eventual outcome. It lives inside the repo you are working on, right next to the code, so reviewers and future sessions read it alongside the diff. The deliverable is not just the code — it is the manifest that explains what\u002Fwhy\u002Fhow.\n\n## Where the manifest lives\n\n**Always inside the repo being worked on**, at `\u003Crepo-root>\u002Ftasks\u002F\u003Cslug>\u002Fmanifest.md`. Resolve `\u003Crepo-root>` from the current working directory: the nearest ancestor that is a repo root (contains `.git` \u002F `pyproject.toml` \u002F `package.json` \u002F similar). In a multi-repo workspace, that is the specific repo the work belongs to — not the workspace root above it.\n\n**Never** write to:\n- The workspace root above any repo. Manifest-collection tooling scans each repo's `tasks\u002F`, so a manifest placed above a repo would be invisible.\n- The skills directory (`~\u002Fskills`) or the skill directory itself.\n- Anywhere outside a repo.\n\nIf the current working directory is a multi-repo workspace root (not inside a specific repo) and the user hasn't named a target repo, **ask which repo this work belongs to** before creating the file. Don't guess.\n\n**Why this matters:** tooling that collects manifest docs looks for `manifest.md` files under each repo's `tasks\u002F**\u002Fmanifest.md`. A manifest in the wrong location (or named anything other than `manifest.md`) won't be picked up, defeating the proactive-update workflow below.\n\nCreate the `tasks\u002F` directory if it does not exist. **Every task gets its own subfolder.** At init, create **only** `tasks\u002F\u003Cslug>\u002Fmanifest.md` — do **not** pre-create `data\u002F`, `artifacts\u002F`, or `runs\u002F` upfront. Each subdir is created **lazily, only when something actually needs to go in it** (the first data file → `data\u002F`, the first probe note\u002Fscript → `artifacts\u002F`, the first validation run → `runs\u002F\u003Cdate>\u002F`). Empty scaffolding directories are noise; a fresh task is just its `manifest.md`.\n\n```\n\u003Crepo-root>\u002Ftasks\u002F\n└── \u003Cslug>\u002F\n    ├── manifest.md      # the living manifest          (template: templates\u002Fmanifest.md)\n    ├── data\u002F            # referenced\u002Fsource inputs only: PDFs, Excel, CSVs, datasets, JSON\n    ├── artifacts\u002F       # inspection notes, scripts,   (template: templates\u002Finspection.md)\n    │                    # probe outputs\n    └── runs\u002F            # dated outputs from actual test\u002Fvalidation runs\n        └── YYYY-MM-DD\u002F  # one folder per run date; SSE logs, tables, run CSVs go here\n```\n\nRules:\n- The manifest is always named **`manifest.md`** (never `\u003Cslug>.md`) — this makes it predictable for tooling (standup collection, grep).\n- **`data\u002F`** holds **referenced \u002F source inputs only** — files given to or consumed by the task (example workbooks, sample PDFs\u002FExcel\u002FCSVs, datasets, JSON inputs). Create it on demand when such a file first enters the task (subfolders OK, e.g. `data\u002Fresults\u002F`). Keep generated virtualenvs, `node_modules`, and caches **out** of the task tree entirely.\n- **`artifacts\u002F`** holds **everything I generate** — inspection notes, one-off scripts\u002Fprobes, AND generated output deliverables (PDFs, guides, derived spreadsheets). Generated files are **never** put in `data\u002F`; if I produced it, it goes here (dated run outputs go in `runs\u002F`).\n- **`runs\u002F`** holds time-stamped outputs from actually firing queries or running validation: SSE logs, parsed tables, benchmark results. One subfolder per date (`YYYY-MM-DD\u002F`). Run outputs stay under their dated folder — they are not moved into `data\u002F`.\n- Never put inspection files, data files, or run outputs at the `tasks\u002F\u003Cslug>\u002F` root — keep the root clean (just `manifest.md` + the subdirs).\n\nCopy from `~\u002Fskills\u002Fmanifest\u002Ftemplates\u002F\u003Cname>.md` when creating the manifest — fill in the title, ask, and any decisions already captured, then leave the rest as placeholders.\n\nSlug: lowercase, hyphenated, imperative (`ndjson-to-parquet-migration`, `add-sso-login`, `refactor-payment-flow`).\n\nThe `tasks\u002F` directory is **gitignored** — manifests, their `data\u002F`, `artifacts\u002F`, and `runs\u002F` are **local-only** and never committed or pushed. Don't try to `git add` them. (When setting up a brand-new repo, add `tasks\u002F` to its `.gitignore` first.)\n\n## Core principle\n\n**Write the manifest before the code, then keep it honest.** Every user answer, every surprise from exploration, every change of plan lands in the manifest in the same session. If the manifest drifts from reality, the workflow has failed.\n\n## When to trigger\n\nInvoke at the **start** of:\n\n- A feature build (e.g. \"add X\", \"support Y\", \"integrate with Z\").\n- A migration (format, schema, dependency, infrastructure).\n- A refactor touching 3+ files.\n- Anything where the user says \"plan\" \u002F \"first figure out\" \u002F \"explore\" \u002F \"let's design\".\n- Any task requiring exploration before implementation is sensible.\n\nSkip for: typo fixes, single-line bug fixes, renames, answering a question, trivial one-shot edits.\n\n## The manifest structure\n\nUse these sections in this order. Sections can be empty with placeholder text; don't skip them.\n\n```markdown\n# \u003CFeature \u002F Task Title>\n\n## Context\nOne paragraph on the ask as you understood it from the user, plus any business or technical background. Not the plan — the problem.\n\n### Decisions\nNumbered list of decisions the user has already made (or made during the session). Each line should stand alone.\n1. \u003Cdecision> — captured \u003Cdate or \"from session\">.\n2. ...\n\n## Exploration Results\nWhat you found in the codebase. Cross-link `file:line` for every claim. Sections suggested (adapt as needed):\n### Consumers \u002F callers\n### Data shape \u002F schema\n### Related subsystems\n### Out of scope\n### Not found\n(Keep this section factual. No plan verbs like \"we will\" or \"let's\".)\n\n## Plan\nCheckbox list of steps. Each step: one line heading + a few sub-bullets describing the edit. Update checkbox state (`[x]`) as you go.\n\n- [ ] **Step 1 — \u003Cname>** `\u003Cpath\u002Fto\u002Ffile>`\n  - What to change\n  - Why \u002F what it unblocks\n\n## Open questions\nNumbered list. When the user answers, append `-> \u003Canswer>` inline on the same line; do not delete the question.\n1. \u003Cquestion>?\n2. \u003Cquestion>? -> \u003Cuser's answer, captured inline>\n\n## Confirmed findings (after real exploration)\nPopulate AFTER running exploration code \u002F probes. Distinguish \"assumed\" from \"confirmed\". Includes:\n- Tables of concrete observations (blob names, schemas, counts).\n- Callouts for surprises that invalidate the initial plan — use ⚠️.\n\n## Testing plan\nConcrete steps. Day-by-day if multi-day. Include: parity baselines, canary, fallback tests, scheduled runs, exit gate.\n\n## Rollout plan\nStages, rollback procedure, coordination notes, gotchas.\n\n## Review\nFill in at the end. Files changed (with one-line per-file summary), how to cut over, known follow-ups, what was flagged out-of-scope.\n```\n\n## Workflow stages\n\n### 1. Capture the ask (before any tool calls other than creating the manifest)\n\n- Read the user's message carefully. Paraphrase the problem back in one sentence before doing anything.\n- Create `tasks\u002F\u003Cslug>\u002Fmanifest.md` populated from the ask — and nothing else; `data\u002F`, `artifacts\u002F`, `runs\u002F` come lazily per the rule above. \"Exploration Results\" and \"Confirmed findings\" are empty placeholders. \"Plan\" has rough shape only — don't overcommit before exploring.\n- If the user gave a spec\u002Flist\u002Ftable, paste it verbatim under **Context** so it's not lost.\n- **After creating the manifest**, write the slug to `tasks\u002F.current-task` (one line, no newline padding) so the shell prompt can display it: `echo -n \"\u003Cslug>\" > tasks\u002F.current-task`. This file is the prompt's source of truth — update it whenever the active task changes mid-session (e.g. user switches to a different task on the same branch).\n\n### 2. Explore\n\n- Use grep \u002F read \u002F file-listing to find consumers, patterns, and current behaviour. Delegate to subagents (Explore \u002F general-purpose) for broad sweeps. Limit direct reads to files you've identified.\n- Write findings to **Exploration Results** as you go — `file:line` references, not summaries.\n- For anything that requires real-world data (bucket contents, DB schema, external API shape), write a **read-only** probe script\u002Fasset\u002Fquery, run it, and save the output under `artifacts\u002F` (e.g. `artifacts\u002Finspection.md`, `artifacts\u002F\u003Cprobe>.csv`). Never guess what remote state looks like.\n- Flag surprises immediately in **Confirmed findings** with ⚠️ — e.g. \"field X is dropped from the new schema\", \"file is unsharded where docs said sharded\".\n\n### 3. Plan + open questions\n\n- Convert exploration into a step-by-step **Plan** with checkboxes. Keep each step minimal — bug fix-sized if possible.\n- Extract decisions the user must make into **Open questions**. Ask them all at once, numbered, so the user can answer inline.\n- When the user answers, edit the manifest: append `-> \u003Canswer>` to each question. Then merge the answer into **Decisions**.\n\n### 4. Implement\n\n- Update the plan's checkboxes as steps complete. Don't batch — mark each done when it's actually done.\n- When a step reveals something unexpected (a missing field, a broken assumption), stop, update **Confirmed findings**, update the plan if scope changed, then continue.\n- For risky writes (DBs, buckets, external systems shared with other envs), design a **local\u002Fdev-only gate** (e.g. a `local_csv_output_dir` config, a `dry_run` flag, a `dev_only` toggle) — then document it in a dedicated subsection of the manifest.\n\n### 5. Tests + rollout\n\n- Write a **Testing plan** with explicit parity baselines (\"diff row counts vs main\"), canary (one asset \u002F one file at a time), fallback verification, and an exit gate.\n- Write a **Rollout plan** with stages, a rollback procedure (ideally config-only, no redeploy), and coordination notes (who needs to know before flipping production).\n- If the user has constraints like \"don't touch demo\", \"dev only\", \"keep fallback\" — surface them at the top of the rollout plan.\n\n### 6. Finalize\n\n- Populate the **Review** section: files changed (with a one-line summary each), how to cut over, follow-ups, out-of-scope items.\n- Offer the next natural step (branch + push + MR, schedule a cleanup agent, etc.) but don't take destructive\u002Fshared actions without confirmation.\n- On `git commit` \u002F branch creation: the commit message should mirror the Review summary. Keep the manifest out of the commit if it's gitignored — otherwise include it.\n\n## Operating rules\n\n- **One manifest per task.** Don't create tiers\u002Fsub-docs unless the user asks for it.\n- **Append-only for decisions and open questions.** Never delete history; strike-through or annotate if a decision reverses.\n- **Real data over assumptions.** If the manifest makes a schema claim, it must be backed by a probe saved alongside.\n- **Update in the same session.** Don't defer updates with \"I'll record this later\".\n- **Cross-link everything.** `file:line` for code claims; relative paths to inspection files; commit SHAs in the Review.\n- **Defer code until the plan is agreed.** If the user hasn't confirmed direction, don't start edits — unless they explicitly said \"just do it\".\n- **Protect shared infra.** When the work touches DBs, buckets, queues, or external services used by demo\u002Fprod, add an isolation knob early and document it.\n- **Never invent skill \u002F subagent \u002F tool names.** Only use ones that exist in the environment.\n\n## Proactive updating — do this without being asked\n\nUpdating the manifest is **part of the task**, not an extra chore the user has to request. Once a manifest exists for the current work, treat every one of the events below as an automatic trigger to edit it in the **same turn** the event happens — before moving on, before the next reply, before running more tools. The user should never have to say \"write this down\" \u002F \"log the decision\" \u002F \"update the task file\".\n\nTriggers that automatically update the manifest (in the same turn):\n\n1. **User answers an Open Question** → append `-> \u003Canswer>` inline on that question, then promote the answer to **Decisions** (numbered, dated).\n2. **User reverses or refines an earlier decision** → strike-through the old decision, add the new one with a date and a `Superseded (YYYY-MM-DD)` tag; never delete the old line.\n3. **User approves a course of action** (\"ok\", \"do it\", \"that's fine\", \"whatever you choose\") → record the concrete choice that was on the table as a Decision before executing.\n4. **Exploration reveals something that invalidates the plan** → add a ⚠️ entry to **Confirmed findings** and update the affected Plan step, in the same turn.\n5. **A plan step completes** → flip its checkbox `[ ]` → `[x]` immediately; if the step split into sub-steps, list them inline.\n6. **New scope added mid-session** → either add a new Plan step or (for a genuinely separate task) spin up a second manifest file; do not silently grow an existing step.\n7. **A follow-up iteration after \"Review\"** (user asks for a tweak after you declared done) → add a **Follow-up increments** subsection under Review with what changed and why, in the same turn. Don't reopen the main Plan unless the change is large.\n8. **Files are edited, created, or deleted** → update **Files changed** in Review the same turn (don't wait until the user asks for a summary).\n9. **`gitignore` \u002F `tasks\u002F` visibility** → if `tasks\u002F` is not in `.gitignore`, note it; if the user wants it local, add it to `.gitignore` without asking again after the first confirmation.\n\nRule of thumb: if you're about to say something in chat that is a **decision, a finding, a change, or a reversal**, the manifest gets the same content first (or at the latest, in the same turn). Chat is ephemeral; the manifest is the record.\n\nWhen you can't tell whether something warrants a manifest update, err toward writing it down — a slightly over-documented manifest costs nothing; a silently-drifted one costs trust.\n\n## Anti-patterns to avoid\n\n- Writing a grand plan before any exploration. Plans written without grepping are fiction.\n- Letting the manifest and the code diverge. If you updated code, update the manifest in the same turn.\n- Mixing \"the ask\" and \"the plan\" in one section. Separate what the user wanted from what you intend to do.\n- Dropping the fallback \u002F rollback section because \"we won't need it\". Keep it — future-you will.\n- Hiding surprises. If exploration invalidates a decision, say so with ⚠️ and update **Decisions** with the revised stance.\n- Committing the manifest without checking gitignore.\n- Narrating every step in chat while the manifest stays sparse. The chat is ephemeral; the manifest is the record.\n- **Waiting to be told, batching updates, or leaving reversed decisions undocumented** — all violations of **Proactive updating** above: update in the same turn, unprompted, keeping superseded decisions struck-through with a date.\n\n## Templates\n\nCopy from `~\u002Fskills\u002Fmanifest\u002Ftemplates\u002F` — but only when each is actually needed (see the lazy-creation rule above), not all upfront:\n\n- `manifest.md` — the main manifest scaffold (Context, Decisions, Exploration Results, Plan, Open questions, Confirmed findings, Testing plan, Rollout plan, Review). Copied **at init** — lands at `tasks\u002F\u003Cslug>\u002Fmanifest.md`.\n- `inspection.md` — for raw exploration probes. Copied **only when you start probing** — lands at `tasks\u002F\u003Cslug>\u002Fartifacts\u002Finspection.md` (creating `artifacts\u002F` then).\n- `notes.md` — free-form scratch. Copied **only when you need it** — lands at `tasks\u002F\u003Cslug>\u002Fartifacts\u002Fnotes.md`.\n\nFor the manifest, fill in the title and any context you already have from the user's ask, then keep the other sections as placeholders to populate as the work progresses.\n\n## Example invocations\n\n- \"Let's add support for parquet in the pipeline\" → create `tasks\u002Fadd-parquet-support\u002Fmanifest.md`, start at stage 1.\n- \"Refactor the auth middleware to use JWT\" → create `tasks\u002Frefactor-auth-to-jwt\u002Fmanifest.md`.\n- \"Migrate sector_exposure to a normalized table\" → create `tasks\u002Fnormalize-sector-exposure\u002Fmanifest.md`.\n- \"Integrate with Acme Payments\" → create `tasks\u002Fintegrate-acme-payments\u002Fmanifest.md`.\n\n## Example\n\n`examples\u002Fmigrate-uploads-to-object-storage.md` is a comprehensive manifest to model yours on: a design-first migration showing a full Context paragraph, a numbered Decisions log (with dates), exploration findings with `file:line` cross-links, a Stack section, a per-layer Plan, testing + rollout plans, and the Review placeholder. Use it to calibrate altitude and how much to capture at each stage.\n\n## Not for\n\n- \"Fix the typo on line 12\" — too small.\n- \"Why is this function slow?\" — it's a question, not a feature.\n- \"Rename `foo` to `bar` across the repo\" — rename, no design surface.\n- Multi-turn conversations where the user has already started implementing without a plan and just wants help finishing — if the manifest would be retrofit, ask first.\n",{"name":5,"description":7},"main","dc89ede1053a613e8f3cbe025b605a2486ffb8c1","hubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fmanifest",0,"https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub","https:\u002F\u002Fauth-02.github.io\u002Fhub\u002F","https:\u002F\u002Fgithub.com\u002Fauth-02","2026-08-12 15:23:18",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add auth-02\u002Fhub --skill manifest",{"tool":38,"command":39},"bunx","bunx skills add auth-02\u002Fhub --skill manifest",{"tool":41,"command":42},"pnpm","pnpm dlx skills add auth-02\u002Fhub --skill manifest","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fmanifest\u002FSKILL.md",true,[46,52,56,60],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"examples\u002Fmigrate-uploads-to-object-storage.md","REFERENCE","参考文档",5518,"https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fmanifest\u002Fexamples\u002Fmigrate-uploads-to-object-storage.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"templates\u002Finspection.md",718,"https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fmanifest\u002Ftemplates\u002Finspection.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"templates\u002Fmanifest.md",1598,"https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fmanifest\u002Ftemplates\u002Fmanifest.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"templates\u002Fnotes.md",398,"https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fmanifest\u002Ftemplates\u002Fnotes.md",[65,72,79,85,92,98],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M755ES8KW0306XX82VJHMJNJ","stacked","Decompose LARGE, complex, or risky changes into a stack of small, dependent, independently reviewable units. Use only when the change is genuinely big: multiple architectural layers with functionally distinct concerns (models + storage + logic + API + UI), or a diff too large to review as one unit. Trigger on \"stacked\" \u002F \"stacked PRs\" \u002F \"stack this\" \u002F how to break down a large change — or when a \"build X\" \u002F \"refactor W\" request is clearly multi-layer and large. Do NOT use for small or moderate changes: bug fixes, tweaks, config, single-file or single-layer changes belong on ONE branch as ONE change — a stack of tiny branches adds overhead without value.","https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fstacked\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M755EBMJGHXN2WGF9T0RG755","kagaz","Kagaz (कागज़) — a personal design system for all frontend and document work — editorial-technical-archival, serif display + mono metadata on warm paper tones with a single rust accent. Use for ANY frontend, UI, web page, landing page, dashboard, artifact, component, mockup, poster, slide deck, report, or PDF\u002Fdocument design, for HTML→PDF conversion, and for any \"make this look good\" \u002F \"style this\" \u002F \"make slides\" \u002F \"turn this into a PDF\" request — even when no design preference is mentioned. Overrides generic AI defaults (Inter-on-white, purple gradients, cool grays). Ships an HTML-to-PDF converter with visual QA and on-brand SVG charts.","https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fkagaz\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M755E9RR0Q8FNNXS5XKY88AZ","dak","https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fdak\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M755E0WG3N8XGTS291CWECCE","change-log","Map a task's changes as an editable draw that renders an interactive change-map on Save — nodes are functional CHANGES (a capability that moved), arrows are dependencies, and clicking a change deep-dives into its file \u002F function \u002F test detail in a side inspector. Use when someone asks \"what changed\", \"map this change\", \"diagram this PR\u002Fbranch\", \"show how the changes connect\", or as the closing step of a task once code has landed. Reads the diff + the task's manifest (the *why*) + Hub's MCP task context, then writes ONE `.excalidraw` into `tasks\u002F\u003Cslug>\u002Fchange-log\u002F`; the user edits it and Saving renders the sibling HTML. The agent does the reading — Hub has no model. `\u002Fchange-log \u003Ctask-slug> [--since \u003Cref>] [--doc]`.","https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fhubspace\u002Fplugin\u002Fhub-agent\u002Fskills\u002Fchange-log\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M755DZDR0YRNBDE7RXEFDAXA","auth","https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fexample\u002Fweb-dashboard\u002Fapp\u002Fskills\u002Fauth\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M755DY7A7MEMV28B9DYWXAJZ","rate_limiting","https:\u002F\u002Fgithub.com\u002Fauth-02\u002Fhub\u002Fblob\u002Fmain\u002Fexample\u002Facme-api\u002Fapp\u002Fskills\u002Frate_limiting\u002FSKILL.md",[],[]]