Cursor rule

1---
2description: Task-Oriented Context Loading
3alwaysApply: true
4---
5 
6# Task-Oriented Context Loading
7 
8Rules for automatically loading appropriate context documents when receiving a task.
9 
10**Key Skill**: Use [label-context-mapping](../skills/label-context-mapping/SKILL.md) for all label → skill/context mappings.
11 
12**SSOT Reference**: See [Task Classification](../../docs/guidelines/task-classification.md) for the authoritative definition of labels and task types.
13 
14## Target Files
15 
16This rule applies when editing the following file types:
17 
18- `**/*.go`
19- `**/*.md`
20- `**/*.toml`
21- `**/*.yaml`
22- `**/*.hcl`
23- `**/*.sql`
24- `**/*.sh`
25- `**/*.proto`
26 
27## Task Detection Priority
28 
291. **GitHub Issue Labels** (if working on an issue) → Use `label-context-mapping` skill
302. **Explicit User Specification** → Second priority
313. **Keyword Detection** → Fallback (see below)
32 
33## Label-Based Context Loading
34 
35When working on a GitHub Issue, load the `label-context-mapping` skill to determine:
36 
37- Type label → Context document
38- Lang/Scope label → Development skill
39- Chain label → Chain context
40 
41See [label-context-mapping](../skills/label-context-mapping/SKILL.md) for complete mappings.
42 
43## Keyword-Based Detection (Fallback)
44 
45If no GitHub labels are available, determine task type from keywords:
46 
47| Keywords                                          | Task Type       | Context File                          |
48| ------------------------------------------------- | --------------- | ------------------------------------- |
49| bug, fix, error, issue                            | `bug`           | `docs/task-contexts/bug-fix.md`       |
50| add, implement, feature, new                      | `enhancement`   | `docs/task-contexts/feature-add.md`   |
51| refactor, reorganize, move, cleanup               | `refactoring`   | `docs/task-contexts/refactoring.md`   |
52| schema, DB, table, column, migration              | `db-change`     | `docs/task-contexts/db-change.md`     |
53| document, README, description, docs, comment      | `documentation` | `docs/task-contexts/documentation.md` |
54| test, coverage, spec, unit test, integration test | `test`          | `docs/task-contexts/test.md`          |
55| security, vulnerability, CVE                      | `security`      | `docs/task-contexts/security.md`      |
56 
57## Chain Detection
58 
59Identify the chain from the following keywords:
60 
61| Keywords                                        | Chain | Context Files                                                       |
62| ----------------------------------------------- | ----- | ------------------------------------------------------------------- |
63| Bitcoin, BTC, Taproot, Descriptor, PSBT, MuSig2 | BTC   | `docs/task-contexts/chain-specific.md`, `docs/chains/btc/README.md` |
64| Bitcoin Cash, BCH, CashAddr                     | BCH   | `docs/task-contexts/chain-specific.md`, `docs/chains/bch/README.md` |
65| Ethereum, ETH, ERC-20, Gas, Nonce               | ETH   | `docs/task-contexts/chain-specific.md`, `docs/chains/eth/README.md` |
66| Ripple, XRP, Destination Tag                    | XRP   | `docs/task-contexts/chain-specific.md`, `docs/chains/xrp/README.md` |
67 
68## File Type Detection for Verification
69 
70Determine appropriate verification commands based on the edited file extension:
71 
72| File Extension     | Required Verification               | Optional       |
73| ------------------ | ----------------------------------- | -------------- |
74| `*.go`             | `make go-lint`, `make check-build`  | `make go-test` |
75| `*.md`, `*.mdc`    | (none)                              | markdownlint   |
76| `*.sql`, `*.hcl`   | `make atlas-fmt`, `make atlas-lint` |                |
77| `*.yaml`, `*.toml` | (none)                              |                |
78| `*.sh`             | (none)                              | shellcheck     |
79| `*.proto`          | `make proto`                        |                |
80 
81**Important**: Do **NOT** run Go-related verification commands for documentation-only (`*.md`) changes.
82 
83See `docs/task-contexts/verification.md` for details.
84 
85## Context Loading Procedure
86 
871. **Determine task type**: Identify task type from user request
882. **Identify chain**: Identify chain if cryptocurrency-related
893. **Load context**: Load the relevant documents
904. **Detect file type**: Check the extension of files to edit
915. **Determine verification commands**: Select verification commands based on file type
92 
93```
94Order:
951. docs/task-contexts/{task-type}.md (by task type)
962. docs/task-contexts/chain-specific.md (if chain-related)
973. docs/chains/{chain}/README.md (for specific chain)
984. docs/task-contexts/verification.md (verification commands)
995. Additional related documents (specified in each context file)
100```
101 
102## Explicit Task Type Specification
103 
104If the user explicitly specifies the task type, follow that type:
105 
106```
107Task Type: bug-fix, Chain: BCH. {description}
108Task Type: feature-add, Chain: BTC. {description}
109Task Type: db-change. {description}
110Task Type: documentation. {description}
111```
112 
113## Chain-Specific Rules
114 
115### BCH (Bitcoin Cash) - Important
116 
117For BCH tasks, always check the following rules:
118 
1191. **Do NOT modify BTC code directly**: Handle BCH-specific issues by overriding methods on the BCH side
1202. **BitcoinCash struct**: Embeds `btc.Bitcoin`
1213. **No SegWit/Taproot support**: Related features are not used in BCH
122 
123```go
124// BCH implementation location
125internal/infrastructure/api/btc/bch/
126 
127// Override example
128func (b *BitcoinCash) GetAddressInfo(addr string) (*dtobtc.AddressInfo, error) {
129    // BCH-specific implementation
130}
131```
132 
133## Directory Structure Reference
134 
135### Use Case Layer
136 
137```
138internal/application/usecase/
139├── keygen/{btc,eth,xrp}/
140├── sign/{btc,eth,xrp}/
141└── watch/{btc,eth,xrp}/
142```
143 
144### Infrastructure Layer
145 
146```
147internal/infrastructure/api/
148├── bitcoin/{btc,bch}/
149├── ethereum/{eth,erc20}/
150└── ripple/xrp/
151```
152 
153### CLI Layer
154 
155```
156internal/interface-adapters/cli/
157├── keygen/api/{btc,eth}/
158├── sign/
159└── watch/api/{btc,eth,xrp}/
160```
161 
162## Verification Commands by File Type
163 
164### Go Files (\*.go)
165 
166```bash
167make go-lint      # Required: Linter check
168make check-build  # Required: Build verification
169make go-test       # Recommended: Run tests (when functionality changes)
170make tidy         # Recommended: Tidy dependencies (when imports change)
171```
172 
173### Documentation Files (\*.md)
174 
175```bash
176# Go-related commands not required
177# Optional: markdownlint (if installed)
178```
179 
180### Database Files (_.sql,_.hcl)
181 
182```bash
183make atlas-fmt    # Required: Format
184make atlas-lint   # Required: Lint
185make sqlc         # On schema change
186```
187 
188### Shell Scripts (\*.sh)
189 
190```bash
191# Optional: shellcheck (if installed)
192```
193 
194## Quick Decision Tree
195 
196```
197Task Received
198    │
199    ├─ Editing Go files?
200    │   └─ Yes → make go-lint, make check-build, (make go-test)
201    │
202    ├─ Documentation only?
203    │   └─ Yes → No verification commands needed
204    │
205    ├─ DB schema change?
206    │   └─ Yes → make atlas-fmt, make atlas-lint, make sqlc
207    │
208    └─ Other
209        └─ Decide based on file type
210```
211 
212## Related Documents
213 
214- [label-context-mapping](../skills/label-context-mapping/SKILL.md) - Label → Skill/Context mapping
215- [Task Classification SSOT](../../docs/guidelines/task-classification.md) - Label definitions
216- [Task Contexts](../../docs/task-contexts/README.md) - Context file details
217- [Verification Matrix](../../docs/task-contexts/verification.md) - Verification commands
218- [AGENTS.md](../../AGENTS.md) - Project-wide guidelines
219