|
| 1 | +--- |
| 2 | +name: gettokens-ops-governance |
| 3 | +description: Core operations and governance for GetTokens. Covers the Wails dev loop (restart rules, readiness), space management in docs-linhay/spaces/, documentation write-back/memory, AGENTS.md sync, and session skill distillation. |
| 4 | +--- |
| 5 | + |
| 6 | +# GetTokens Operations & Governance |
| 7 | + |
| 8 | +This skill unifies the procedural rules for working on GetTokens, ensuring consistency in development, documentation, and knowledge management. |
| 9 | + |
| 10 | +## 1. Wails Dev Loop & Restart Rules |
| 11 | +- **Restart**: Always restart the app if Go files, Wails bindings, or sidecar logic change. Restart for Svelte/CSS if HMR shows stale results. |
| 12 | +- **Readiness**: Sidecar `ready` status is required for account data flow. UI mount success does not guarantee data flow. |
| 13 | +- **Verification**: Only claim a fix is live after verifying it in the actual desktop app window, not just the browser. |
| 14 | + |
| 15 | +## 2. Space Governance (`docs-linhay/spaces/`) |
| 16 | +- **Structure**: Each space must have `README.md`, `plans/`, `screenshots/`, and `debate/`. |
| 17 | +- **Naming**: Use English slugs. Prefer `YYYYMMDD-<topic>` for short tasks or stable feature names for milestones. |
| 18 | +- **Content**: Put requirements in the space `README.md`. Use specific naming conventions for screenshots: `<YYYYMMDD>-<module>-<scene>-<status>-v<nn>.png`. |
| 19 | + |
| 20 | +## 3. Doc Write-back & AGENTS Sync |
| 21 | +- **Placement**: |
| 22 | + - Scope/Requirements -> `docs-linhay/spaces/` |
| 23 | + - Design/Workflow -> `docs-linhay/dev/` |
| 24 | + - Decisions/Milestones -> `docs-linhay/memory/` |
| 25 | + - Rules -> `AGENTS.md` |
| 26 | +- **Memory**: Keep entries concise and decision-oriented. Run `qmd update` and `qmd embed` after any write-back. |
| 27 | +- **Governance**: Read `AGENTS.md` first. Update it only for repo-wide, durable rules. Ensure `docs-linhay` is not ignored in `.gitignore`. |
| 28 | + |
| 29 | +## 4. Session Skill Distillation |
| 30 | +- **Trigger**: When asked to "整理" or after a pattern-heavy session. |
| 31 | +- **Goal**: Extract durable workflows and failure modes into skills. Avoid copying transient guesses or chat fluff. |
| 32 | +- **Output**: Create/update skills in `.agents/skills/` and record the decision in project memory. |
| 33 | + |
| 34 | +## Acceptance Checklist |
| 35 | +- App launches with latest code and reaches `ready` state. |
| 36 | +- Space boundaries are clear; screenshots and debate notes follow naming rules. |
| 37 | +- Durable knowledge is written to the correct directory and indexed via `qmd`. |
| 38 | +- New skills or rules are distilled without bloating governance files. |
0 commit comments