init
This commit is contained in:
41
2026-08-11-SFY-IC-Debrief.md
Normal file
41
2026-08-11-SFY-IC-Debrief.md
Normal file
@@ -0,0 +1,41 @@
|
||||
# SPY Iron Condor Debrief — 2026-08-11
|
||||
|
||||
## Trade Summary
|
||||
- **Ticker:** SPY
|
||||
- **Structure:** Iron Condor (8/14 expiry)
|
||||
- 770P/760P (put side)
|
||||
- 780C/785C (call side)
|
||||
- **Credit:** $2.44/contract
|
||||
- **Entry:** ~$773.70 at ~10:29 AM ET
|
||||
- **Exit:** ~11:30 AM ET (time exit)
|
||||
- **Result:** -$6 net loss
|
||||
|
||||
## Plan
|
||||
- **Target:** 25% profit ($1.83 buyback)
|
||||
- **Time Exit:** 11:30 AM ET
|
||||
- **Guard:** Close if approaching breakevens ($768.44 / $782.44)
|
||||
|
||||
## Observations
|
||||
- **Asymmetric Structure:** 10-wide put side, 5-wide call side
|
||||
- Riskier put wing got more buffer
|
||||
- Better credit optimization on the closer strike
|
||||
- **NL3 Feed Issue:** Institutional prints showing zero throughout session
|
||||
- Feed likely stale/disconnected
|
||||
- Normal SPY volume should show dozens of prints by 10:30 AM
|
||||
- **Price Action:** SPY drifted from $773.70 to around exit
|
||||
- Put side was always the danger zone ($3.70 vs $6.30 to calls)
|
||||
- Theta grind on 3-day 0DTE can be unforgiving
|
||||
|
||||
## Key Takeaways
|
||||
1. **Asymmetric IC Design:** Good structure — wider put side matched the closer risk
|
||||
2. **Time Management:** Respected the 11:30 exit window cleanly
|
||||
3. **NL3 Reliability:** Feed issues need monitoring — toggle off/on when zero prints show
|
||||
4. **Small Losses:** -$6 on a $2.44 credit is noise, not strategy failure
|
||||
|
||||
## Next Time
|
||||
- Consider waiting for more theta decay before entry
|
||||
- Monitor NL3 feed health at session start
|
||||
- Stick to the plan — execution was clean, just unfavorable drift
|
||||
|
||||
---
|
||||
*Auto-debrief generated at exit*
|
||||
58
260731-1330-credit-spread.md
Normal file
58
260731-1330-credit-spread.md
Normal file
@@ -0,0 +1,58 @@
|
||||
# SPY Bull Put Credit Spread — 2026-07-31 1:30 PM ET
|
||||
|
||||
**Date:** 2026-07-31
|
||||
**Session time:** 1:30 PM ET
|
||||
**Asset:** SPY
|
||||
**Expiration:** July 31, 2026 (0DTE)
|
||||
**Direction:** Bullish — slow grind higher
|
||||
|
||||
---
|
||||
|
||||
## Trade specs
|
||||
|
||||
| Field | Value |
|
||||
|---|---|
|
||||
| Strategy | Bull Put Credit Spread |
|
||||
| Short put (sell) | $740 |
|
||||
| Long put (buy) | $738 |
|
||||
| Width | $2 |
|
||||
| Credit target | ~$0.40–$0.60 |
|
||||
| Max profit | credit received (20-30%+ of width with 0DTE theta) |
|
||||
| Breakeven | $739.40–$739.60 |
|
||||
| SPY price at time | $744.72 |
|
||||
| Day range | $737.68 – $746.30 |
|
||||
| Time remaining | ~2h 50m |
|
||||
|
||||
## Thesis
|
||||
|
||||
SPY is holding the upper 80% of today's range on low volume (39% of average). Low volume + upper register holding often prints a slow grind higher rather than rejection. A credit spread is preferred because theta works in our favor — every minute of 0DTE decay adds to profit. We don't need SPY to rally; we just need it to stay above $740.
|
||||
|
||||
## Key levels
|
||||
|
||||
- **Resistance:** $746.30 (today's high), $748 (mid-week), $750 (psychological)
|
||||
- **Support:** $741.69 (yesterday's close), $737.68 (today's low)
|
||||
|
||||
## Entry
|
||||
|
||||
- Sell $740 / Buy $738 put spread
|
||||
- Target credit: $0.40–$0.60 (20-30%+ of width)
|
||||
|
||||
## Exit plan
|
||||
|
||||
- **20% profit:** credit of ~$0.50 → sell 50% at 20% back (~$0.10 credit retained)
|
||||
- **Runner:** trail remaining 50%, close if bid drops toward breakeven
|
||||
- **Stop / defense:** SPY closes below $739 → consider early exit or roll
|
||||
- **Max risk:** width minus credit (~$1.40–$1.60/contract)
|
||||
|
||||
## Why credit spread over debit spread
|
||||
|
||||
- **Theta works for us** — 0DTE decay accelerates all day, especially after ~3:30 PM
|
||||
- Higher probability — spread is well OTM below yesterday's close ($741.69)
|
||||
- We profit from the grind *and* from the standstill
|
||||
- Debit spread needed active upside; credit spread profits from not failing
|
||||
|
||||
## Notes
|
||||
|
||||
- Low volume today may cap upside speed but also reduces downside momentum
|
||||
- Theta accelerates sharply in final 2 hours — monitor decay rate after 3:30 PM
|
||||
- If volume spikes downward, reassess the $740 support level
|
||||
94
README.md
Normal file
94
README.md
Normal file
@@ -0,0 +1,94 @@
|
||||
# Tool Catalog
|
||||
|
||||
This README catalogs the tools and resources in this directory. It is intended for humans and LLM agents to quickly identify what is available and when to use it.
|
||||
|
||||
## Catalog
|
||||
|
||||
| Tool / Folder | Purpose | Key Files | When to Use |
|
||||
| --- | --- | --- | --- |
|
||||
| `tool-catalog-maintainer/` | Creates and maintains catalog READMEs for directories of tools/resources. | `SKILL.md`, `CONTEXT.md`, `references/catalog-format.md` | Use when asked to catalog, index, or update documentation for a folder of tools. |
|
||||
| `research-dfns/` | DFNS research folder — alerts logs, chat log, and TODO tracking. | `TODO.md`, `AlertsLog_*.txt`, `ChatLog_*.txt` | Use when reviewing or continuing DFNS research. |
|
||||
| `260731-1330-credit-spread.md` | SPY Bull Put Credit Spread trade plan (0DTE, July 31). | `260731-1330-credit-spread.md` | Use for today's SPY options trade — bullish slow grind thesis. |
|
||||
| `iron-condor-45dte.md` | SPX Iron Condor trade plan — 45DTE entry, 21DTE time exit, Schwab broker. | `iron-condor-45dte.md` | Use when setting up or managing SPX iron condor spreads. |
|
||||
| `cha-martin-watchlist.ms.csv` | Cha Martin watchlist export (CSV). | `cha-martin-watchlist.ms.csv` | Use for ticker watchlist reference or scan filtering. |
|
||||
|
||||
## Tools
|
||||
|
||||
### `tool-catalog-maintainer/`
|
||||
|
||||
**Purpose:**
|
||||
Creates and maintains a `README.md` catalog for a directory containing subfolders of tools, prompts, scripts, docs, workflows, skills, or other reusable resources. The README is a living catalog that improves over time.
|
||||
|
||||
**Contents:**
|
||||
- `SKILL.md` — skill definition and workflow
|
||||
- `CONTEXT.md` — full context: inputs, process, outputs, verification
|
||||
- `references/catalog-format.md` — catalog README structure and cataloging rules
|
||||
- `output/` — generated artifacts
|
||||
|
||||
**Use when:**
|
||||
You need to catalog, index, summarize, or update documentation for a folder of tools so humans or LLM agents can quickly choose the right resource.
|
||||
|
||||
**Setup / dependencies:**
|
||||
None noted. Works with file read/write tools.
|
||||
|
||||
**Notes:**
|
||||
Always use this tool when asked to catalog a directory — inspect subfolders, read their key files, and write the README using `references/catalog-format.md`.
|
||||
|
||||
### `research-dfns/`
|
||||
|
||||
**Purpose:**
|
||||
Research folder for DFNS (Digital Frontier Acquisition Corp.) — contains alert logs, chat transcripts, and tracking notes from July 27, 2026.
|
||||
|
||||
**Contents:**
|
||||
- `TODO.md` — research tracking tasks
|
||||
- `AlertsLog_Mon Jul 27 2026*.txt` — alert logs (3 files)
|
||||
- `ChatLog_Mon Jul 27 2026.txt` — chat transcript
|
||||
|
||||
**Use when:**
|
||||
Reviewing or continuing DFNS research. Note: per ticker tracking rule, DFNS should not be actively tracked unless a fresh positive reason arises.
|
||||
|
||||
**Setup / dependencies:**
|
||||
None noted.
|
||||
|
||||
### `260731-1330-credit-spread.md`
|
||||
|
||||
**Purpose:**
|
||||
Active trade plan for a SPY Bull Put Credit Spread (0DTE, July 31, 2026). Sell $740 put / Buy $738 put spread, targeting 20%+ profit with bullish slow grind thesis.
|
||||
|
||||
**Use when:**
|
||||
Executing or monitoring today's SPY options trade.
|
||||
|
||||
**Setup / dependencies:**
|
||||
None noted. Trade-specific, not reusable.
|
||||
|
||||
### `iron-condor-45dte.md`
|
||||
|
||||
**Purpose:**
|
||||
Trade plan for SPX Iron Condor through Schwab broker. 45DTE entry, 30-point wings, forced close at 21DTE. Includes profit target (25% of net credit), stop loss (50% of max loss), and monitoring cadence.
|
||||
|
||||
**Use when:**
|
||||
Setting up or managing SPX iron condor spreads with Schwab.
|
||||
|
||||
**Setup / dependencies:**
|
||||
Schwab broker session required.
|
||||
|
||||
### `cha-martin-watchlist.ms.csv`
|
||||
|
||||
**Purpose:**
|
||||
CSV export of a Cha Martin watchlist — likely contains tickers for scanning or monitoring.
|
||||
|
||||
**Use when:**
|
||||
Referencing tickers for scans, short squeeze candidates, or watchlist filtering.
|
||||
|
||||
**Setup / dependencies:**
|
||||
None noted.
|
||||
|
||||
## Maintenance Notes
|
||||
|
||||
When adding or updating a tool folder, update this README with:
|
||||
|
||||
- purpose
|
||||
- key files and entry points
|
||||
- usage guidance
|
||||
- setup requirements
|
||||
- notable changes or cautions
|
||||
55
cha-martin-watchlist.ms.csv
Normal file
55
cha-martin-watchlist.ms.csv
Normal file
@@ -0,0 +1,55 @@
|
||||
AAPL
|
||||
UPS
|
||||
UBER
|
||||
TSM
|
||||
TSLS
|
||||
TSLA
|
||||
TGT
|
||||
TAN
|
||||
SQQQ
|
||||
SPY
|
||||
SPX
|
||||
SOXL
|
||||
SEDG
|
||||
SBUX
|
||||
RUN
|
||||
ROKU
|
||||
RIVN
|
||||
RBLX
|
||||
QQQ
|
||||
PYPL
|
||||
PLTR
|
||||
PINS
|
||||
PANW
|
||||
NVDA
|
||||
NKE
|
||||
NFLX
|
||||
MU
|
||||
MSFT
|
||||
META
|
||||
KRE
|
||||
INTC
|
||||
HOOD
|
||||
HD
|
||||
GOOGL
|
||||
GOOG
|
||||
FSLR
|
||||
FDX
|
||||
ETSY
|
||||
ENPH
|
||||
DIS
|
||||
DE
|
||||
DDOG
|
||||
CRWD
|
||||
CRM
|
||||
COST
|
||||
COIN
|
||||
CAT
|
||||
BITO
|
||||
BABA
|
||||
BA
|
||||
ARKK
|
||||
AMZN
|
||||
AMD
|
||||
AFRM
|
||||
ADBE
|
||||
|
26
iron-condor-45dte.md
Normal file
26
iron-condor-45dte.md
Normal file
@@ -0,0 +1,26 @@
|
||||
```
|
||||
Iron Condor 45dte Trade Plan
|
||||
```
|
||||
|
||||
Trade plan request:
|
||||
|
||||
Execute an iron condor on SPX through my Schwab broker session.
|
||||
|
||||
Underlying: SPX Broker: Schwab Strategy: Iron Condor (4 legs) Entry DTE: ~45 days Wing width: 30 points Spread legs:
|
||||
|
||||
Short put: [strike]
|
||||
Long put: [strike]
|
||||
Short call: [strike]
|
||||
Long call: [strike] Net credit: $[] Max loss: $[]
|
||||
Exit rules:
|
||||
|
||||
Profit target: Close all 4 legs at 25% of net credit
|
||||
Stop loss: Close all 4 legs at 50% loss of max loss
|
||||
Time exit: Close all 4 legs unconditionally on [date — 21 calendar days from entry]
|
||||
Broker hard stop: Set a Schwab-side stop order at 50% loss as offline protection. Cancel automatically once MARI closes the position.
|
||||
Monitoring cadence: Swing pace — check net position P&L multiple times per trading day. No intra-second polling needed.
|
||||
|
||||
Close all 4 legs together. Do not roll or manage legs individually.
|
||||
|
||||
Review the plan with me before execution. Confirm buying power and order preview before placing.
|
||||
|
||||
74
scan-watchlist.md
Normal file
74
scan-watchlist.md
Normal file
@@ -0,0 +1,74 @@
|
||||
|
||||
## Plan: Watchlist Confluence Scan
|
||||
|
||||
### Phase 1 — Broad filter across all 54 tickers (~5-8 tool calls)
|
||||
|
||||
**1. Market context snapshot**
|
||||
- Pull `SPY` and `QQQ` snapshots to establish the day's market regime (trend, range, key levels). Everything filters through this — no short setups in a strong uptrend day, no longs into a breakdown.
|
||||
|
||||
**2. Batch screen for daily structure**
|
||||
- Run a Finviz scan (or equivalent) filtering for:
|
||||
- Price within ~3% of the 50-day MA (your stated preference)
|
||||
- Consolidation/base pattern or pullback setup
|
||||
- Above/below VWAP context
|
||||
- This narrows 54 → likely 10-15 candidates worth deeper review.
|
||||
|
||||
**3. Parallel ticker snapshots**
|
||||
- Pull `snapshot` data for the ~10-15 candidates from Phase 2 to get:
|
||||
- Current price, day range, volume vs average
|
||||
- Pre-market action (gappers up/down)
|
||||
- % change from 50MA (if available from scan data)
|
||||
|
||||
### Phase 2 — Confluence analysis on the shortlist (~3-4 calls per ticker × 5-8 tickers)
|
||||
|
||||
For each candidate, evaluate these confluence factors:
|
||||
|
||||
| Factor | Tool / Source | What I'm looking for |
|
||||
|--------|--------------|----------------------|
|
||||
| **Daily chart structure** | `chart_command` — load symbol, D timeframe | Trend direction, price vs 50MA/200MA, support/resistance zones, base/consolidation patterns |
|
||||
| **Intraday setup** | `chart_command` — 3-min or 5-min chart | VWAP relationship, pre-market gap vs overnight range, opening range break potential |
|
||||
| **Volume profile** | `chart_command` — volume indicator | Above-average volume confirming the move, or thin volume suggesting trap |
|
||||
| **Options flow / unusual activity** | `mcp` → `ttg-options` chain snapshot | Unusual call/put volume, max pain, gamma exposure — institutional positioning signal |
|
||||
| **Relative strength** | Visual chart comparison | Is it holding while the sector/market sells? That's a Mike-style confluence flag |
|
||||
|
||||
### Phase 3 — Trade plan construction on top setups (2-4 tickers max)
|
||||
|
||||
For the 2-4 tickers with the strongest confluence:
|
||||
|
||||
**1. Chart the setup**
|
||||
- Load the ticker on AI chart with overlays: VWAP, 50 EMA, key S/R levels drawn
|
||||
- Identify the exact entry zone, stop level, and target levels (T1/T2/T3)
|
||||
|
||||
**2. Draft the trade plan**
|
||||
- Symbol, side, entry zone, stop, targets, time horizon
|
||||
- **Rationale**: confluence factors that align (daily structure + intraday trigger + flow confirmation)
|
||||
- **What invalidates it**: the one condition that kills the thesis
|
||||
|
||||
**3. Options structure**
|
||||
- Given your preference for credit spreads, evaluate:
|
||||
- Credit spread strikes (defined risk, collect premium)
|
||||
- Bid-ask spread width (< $0.25 preferred for scalps)
|
||||
- Time decay working in your favor
|
||||
|
||||
### Phase 4 — Summary card
|
||||
|
||||
Deliver a structured card showing:
|
||||
- Top 3-5 setups ranked by confluence score
|
||||
- Each with: setup type, entry/stop/targets, key confluence factors, risk level
|
||||
- The "sitting on hands" list — tickers that looked okay but lacked a decisive edge
|
||||
|
||||
---
|
||||
|
||||
### Estimated tool call count
|
||||
- **Phase 1:** ~8-10 calls
|
||||
- **Phase 2:** ~15-25 calls (depending on shortlist size)
|
||||
- **Phase 3:** ~5-8 calls
|
||||
- **Phase 4:** 1 card build call
|
||||
|
||||
**Total: ~30-45 tool calls** — this is a substantive scan. I'd recommend we do Phase 1 first to see the shortlist, then you can approve Phase 2 on the narrowed candidates rather than burning through credits on all 54.
|
||||
|
||||
### Key question before I proceed:
|
||||
1. **Long only, or long + short?** You've expressed interest in both — what's the bias today?
|
||||
2. **Time horizon:** 0DTE intraday scalps, or day/swing holds?
|
||||
3. **Asset class focus:** Equities only, or include ETFs (SPY/QQQ/TAN/SOXL/SQQQ/KRE) in the confluence review?
|
||||
|
||||
25
workflows/research-dfns/AlertsLog_Mon Jul 27 2026 (1).txt
Normal file
25
workflows/research-dfns/AlertsLog_Mon Jul 27 2026 (1).txt
Normal file
@@ -0,0 +1,25 @@
|
||||
7/27/2026, 08:19 AM [Admin]: Alerts Cleared.
|
||||
7/27/2026, 09:38 AM [Cha Martin]: #INTERMEDIATE #OPTION #SWING stopped out 7/31 $ORCL 106P/.40
|
||||
7/27/2026, 09:40 AM [Cha Martin]: #ADVANCED #OPTION #DAY bought 7/31 $NVDA 195P/1.18 stop area 207 (TIER 1)
|
||||
7/27/2026, 09:41 AM [Jay Downing]: #EQUITY stopped covered QBTS @19.10 from 7/25**
|
||||
7/27/2026, 09:43 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/1.7 still holding some
|
||||
7/27/2026, 09:46 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/1.9 still holding some
|
||||
7/27/2026, 10:23 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/2.32 still holding some
|
||||
7/27/2026, 10:28 AM [Cha Martin]: #ADVANCED #OPTION #SCALP bought 7/31 $NVDA 185P/.70 stop area 200.5 (1/2 TIER 1)
|
||||
7/27/2026, 10:35 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/2.84 still holding some
|
||||
7/27/2026, 10:36 AM [Chris Toner]: #INTERMEDIATE #OPTION #SWING buying 7/31 TLT 83.50put $0.34 (stop 0.15)
|
||||
7/27/2026, 10:36 AM [Cha Martin]: #ADVANCED #OPTION #SCALP took profit 7/31 $NVDA 185P/.79 still holding some
|
||||
7/27/2026, 10:36 AM [Chris Toner]: #INTERMEDIATE #OPTION #SWING buying 7/31 NEE 89.00put $0.90 (stop 0.50)
|
||||
7/27/2026, 11:13 AM [Michael Edward]: #ADVANCED #EQUITY #DAY long Tier 1 (25% of normal size) $DFNS $6.83 stop loss $6.25 area (short squeeze or bust type of play) will add Tier 2 through $7.25
|
||||
7/27/2026, 11:39 AM [Cha Martin]: #ADVANCED #OPTION #SCALP took profit 7/31 $NVDA 185P/1.19 still holding some
|
||||
7/27/2026, 12:13 PM [Michael Edward]: #ADVANCED #EQUITY #DAY added Tier 2 $DFNS $7.18 stop loss $6.75 area
|
||||
7/27/2026, 12:14 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took some profit $DFNS $7.65 still holding some
|
||||
7/27/2026, 12:14 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $8.21 still holding some
|
||||
7/27/2026, 12:20 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $9.19 still holding some
|
||||
7/27/2026, 01:08 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $10.08 still holding small piece
|
||||
7/27/2026, 01:47 PM [Michael Edward]: #ADVANCED #EQUITY #DAY final take profit $DFNS $11.88
|
||||
7/27/2026, 01:57 PM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/3.5 still holding some
|
||||
7/27/2026, 01:57 PM [Chris Toner]: #INTERMEDIATE #OPTION #SWING taking profit 7/31 NEE 89.00put $1.40 (still holding some)
|
||||
7/27/2026, 04:01 PM [Michael Edward]: #ADVANCED #EQUITY #DAY long $DFNS $13.23 stop loss $11.00 area (extreme risk no more than 1/2 size short squeeze or bust type of play)
|
||||
7/27/2026, 04:13 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took some profit $DFNS $15.71 still holding some
|
||||
7/27/2026, 04:15 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $17.30 still holding some
|
||||
27
workflows/research-dfns/AlertsLog_Mon Jul 27 2026 (2).txt
Normal file
27
workflows/research-dfns/AlertsLog_Mon Jul 27 2026 (2).txt
Normal file
@@ -0,0 +1,27 @@
|
||||
7/27/2026, 08:19 AM [Admin]: Alerts Cleared.
|
||||
7/27/2026, 09:38 AM [Cha Martin]: #INTERMEDIATE #OPTION #SWING stopped out 7/31 $ORCL 106P/.40
|
||||
7/27/2026, 09:40 AM [Cha Martin]: #ADVANCED #OPTION #DAY bought 7/31 $NVDA 195P/1.18 stop area 207 (TIER 1)
|
||||
7/27/2026, 09:41 AM [Jay Downing]: #EQUITY stopped covered QBTS @19.10 from 7/25**
|
||||
7/27/2026, 09:43 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/1.7 still holding some
|
||||
7/27/2026, 09:46 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/1.9 still holding some
|
||||
7/27/2026, 10:23 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/2.32 still holding some
|
||||
7/27/2026, 10:28 AM [Cha Martin]: #ADVANCED #OPTION #SCALP bought 7/31 $NVDA 185P/.70 stop area 200.5 (1/2 TIER 1)
|
||||
7/27/2026, 10:35 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/2.84 still holding some
|
||||
7/27/2026, 10:36 AM [Chris Toner]: #INTERMEDIATE #OPTION #SWING buying 7/31 TLT 83.50put $0.34 (stop 0.15)
|
||||
7/27/2026, 10:36 AM [Cha Martin]: #ADVANCED #OPTION #SCALP took profit 7/31 $NVDA 185P/.79 still holding some
|
||||
7/27/2026, 10:36 AM [Chris Toner]: #INTERMEDIATE #OPTION #SWING buying 7/31 NEE 89.00put $0.90 (stop 0.50)
|
||||
7/27/2026, 11:13 AM [Michael Edward]: #ADVANCED #EQUITY #DAY long Tier 1 (25% of normal size) $DFNS $6.83 stop loss $6.25 area (short squeeze or bust type of play) will add Tier 2 through $7.25
|
||||
7/27/2026, 11:39 AM [Cha Martin]: #ADVANCED #OPTION #SCALP took profit 7/31 $NVDA 185P/1.19 still holding some
|
||||
7/27/2026, 12:13 PM [Michael Edward]: #ADVANCED #EQUITY #DAY added Tier 2 $DFNS $7.18 stop loss $6.75 area
|
||||
7/27/2026, 12:14 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took some profit $DFNS $7.65 still holding some
|
||||
7/27/2026, 12:14 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $8.21 still holding some
|
||||
7/27/2026, 12:20 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $9.19 still holding some
|
||||
7/27/2026, 01:08 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $10.08 still holding small piece
|
||||
7/27/2026, 01:47 PM [Michael Edward]: #ADVANCED #EQUITY #DAY final take profit $DFNS $11.88
|
||||
7/27/2026, 01:57 PM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/3.5 still holding some
|
||||
7/27/2026, 01:57 PM [Chris Toner]: #INTERMEDIATE #OPTION #SWING taking profit 7/31 NEE 89.00put $1.40 (still holding some)
|
||||
7/27/2026, 04:01 PM [Michael Edward]: #ADVANCED #EQUITY #DAY long $DFNS $13.23 stop loss $11.00 area (extreme risk no more than 1/2 size short squeeze or bust type of play)
|
||||
7/27/2026, 04:13 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took some profit $DFNS $15.71 still holding some
|
||||
7/27/2026, 04:15 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $17.30 still holding some
|
||||
7/27/2026, 05:38 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $20.24 still holding small piece
|
||||
7/27/2026, 05:55 PM [Michael Edward]: #ADVANCED #EQUITY #DAY final take profit $DFNS $18.24
|
||||
25
workflows/research-dfns/AlertsLog_Mon Jul 27 2026.txt
Normal file
25
workflows/research-dfns/AlertsLog_Mon Jul 27 2026.txt
Normal file
@@ -0,0 +1,25 @@
|
||||
7/27/2026, 08:19 AM [Admin]: Alerts Cleared.
|
||||
7/27/2026, 09:38 AM [Cha Martin]: #INTERMEDIATE #OPTION #SWING stopped out 7/31 $ORCL 106P/.40
|
||||
7/27/2026, 09:40 AM [Cha Martin]: #ADVANCED #OPTION #DAY bought 7/31 $NVDA 195P/1.18 stop area 207 (TIER 1)
|
||||
7/27/2026, 09:41 AM [Jay Downing]: #EQUITY stopped covered QBTS @19.10 from 7/25**
|
||||
7/27/2026, 09:43 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/1.7 still holding some
|
||||
7/27/2026, 09:46 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/1.9 still holding some
|
||||
7/27/2026, 10:23 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/2.32 still holding some
|
||||
7/27/2026, 10:28 AM [Cha Martin]: #ADVANCED #OPTION #SCALP bought 7/31 $NVDA 185P/.70 stop area 200.5 (1/2 TIER 1)
|
||||
7/27/2026, 10:35 AM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/2.84 still holding some
|
||||
7/27/2026, 10:36 AM [Chris Toner]: #INTERMEDIATE #OPTION #SWING buying 7/31 TLT 83.50put $0.34 (stop 0.15)
|
||||
7/27/2026, 10:36 AM [Cha Martin]: #ADVANCED #OPTION #SCALP took profit 7/31 $NVDA 185P/.79 still holding some
|
||||
7/27/2026, 10:36 AM [Chris Toner]: #INTERMEDIATE #OPTION #SWING buying 7/31 NEE 89.00put $0.90 (stop 0.50)
|
||||
7/27/2026, 11:13 AM [Michael Edward]: #ADVANCED #EQUITY #DAY long Tier 1 (25% of normal size) $DFNS $6.83 stop loss $6.25 area (short squeeze or bust type of play) will add Tier 2 through $7.25
|
||||
7/27/2026, 11:39 AM [Cha Martin]: #ADVANCED #OPTION #SCALP took profit 7/31 $NVDA 185P/1.19 still holding some
|
||||
7/27/2026, 12:13 PM [Michael Edward]: #ADVANCED #EQUITY #DAY added Tier 2 $DFNS $7.18 stop loss $6.75 area
|
||||
7/27/2026, 12:14 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took some profit $DFNS $7.65 still holding some
|
||||
7/27/2026, 12:14 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $8.21 still holding some
|
||||
7/27/2026, 12:20 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $9.19 still holding some
|
||||
7/27/2026, 01:08 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $10.08 still holding small piece
|
||||
7/27/2026, 01:47 PM [Michael Edward]: #ADVANCED #EQUITY #DAY final take profit $DFNS $11.88
|
||||
7/27/2026, 01:57 PM [Cha Martin]: #ADVANCED #OPTION #DAY took profit 7/31 $NVDA 195P/3.5 still holding some
|
||||
7/27/2026, 01:57 PM [Chris Toner]: #INTERMEDIATE #OPTION #SWING taking profit 7/31 NEE 89.00put $1.40 (still holding some)
|
||||
7/27/2026, 04:01 PM [Michael Edward]: #ADVANCED #EQUITY #DAY long $DFNS $13.23 stop loss $11.00 area (extreme risk no more than 1/2 size short squeeze or bust type of play)
|
||||
7/27/2026, 04:13 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took some profit $DFNS $15.71 still holding some
|
||||
7/27/2026, 04:15 PM [Michael Edward]: #ADVANCED #EQUITY #DAY took more profit $DFNS $17.30 still holding some
|
||||
1151
workflows/research-dfns/ChatLog_Mon Jul 27 2026.txt
Normal file
1151
workflows/research-dfns/ChatLog_Mon Jul 27 2026.txt
Normal file
File diff suppressed because it is too large
Load Diff
10
workflows/research-dfns/TODO.md
Normal file
10
workflows/research-dfns/TODO.md
Normal file
@@ -0,0 +1,10 @@
|
||||
260727 Mike identified DFNS as a SS candidate. I took the trade around the same time he did and MARI set the stop. Well, it stopped out and a little later popped for a win. It continued all day and even a reload candidate for after hours continuation.
|
||||
|
||||
I've inclued the alert and chat log from the day to analyze with other analysis of the price action that is not collected yet
|
||||
|
||||
The point is:
|
||||
- rev engineer what Mike saw in this one?
|
||||
- why play it the way he direted?
|
||||
- Conversing with MARI about it's analysis and conclusions that helped me to fail are over. Now it's on to what would I do next time?
|
||||
|
||||
|
||||
17
workflows/scan-watchlist-icm/CLAUDE.md
Normal file
17
workflows/scan-watchlist-icm/CLAUDE.md
Normal file
@@ -0,0 +1,17 @@
|
||||
# Scan Watchlist ICM Workspace
|
||||
|
||||
This workspace orchestrates a multi-stage watchlist confluence scan for trading ideas.
|
||||
The agent follows the numbered stages to filter tickers, analyze confluence, construct trade plans, and produce a summary card.
|
||||
|
||||
Folder structure:
|
||||
- CLAUDE.md (Layer 0): workspace identity
|
||||
- CONTEXT.md (Layer 1): workspace-level routing
|
||||
- stages/: numbered stage folders
|
||||
- 00_clarify/: ask key questions
|
||||
- 01_broad_filter/: broad filter across tickers
|
||||
- 02_confluence_analysis/: confluence analysis on shortlist
|
||||
- 03_trade_plan/: trade plan construction
|
||||
- 04_summary_card/: summary card creation
|
||||
- _config/: Layer 3 reference material (stable across runs)
|
||||
- shared/: Layer 3 shared references
|
||||
- Each stage's output/ holds Layer 4 working artifacts for handoff to next stage.
|
||||
16
workflows/scan-watchlist-icm/CONTEXT.md
Normal file
16
workflows/scan-watchlist-icm/CONTEXT.md
Normal file
@@ -0,0 +1,16 @@
|
||||
# Workspace Context: Watchlist Confluence Scan
|
||||
|
||||
## Routing
|
||||
Given the goal to scan 54 tickers for trade setups with confluence, the workflow proceeds through stages:
|
||||
|
||||
1. **00_clarify** - Ask clarifying questions about long/short bias, time horizon, asset class focus.
|
||||
2. **01_broad_filter** - Perform broad filter across all tickers to narrow candidates.
|
||||
3. **02_confluence_analysis** - Analyze confluence factors for each candidate.
|
||||
4. **03_trade_plan** - Construct detailed trade plans for top setups.
|
||||
5. **04_summary_card** - Produce a structured summary card of setups and sitting-on-hands list.
|
||||
|
||||
## Shared Resources
|
||||
- _config/: Contains references such as ticker list, default parameters.
|
||||
- shared/: May contain common tools or scripts (if any).
|
||||
|
||||
The agent should read the stage's CONTEXT.md for detailed inputs, process, and outputs.
|
||||
14
workflows/scan-watchlist-icm/_config/trade_plan_template.md
Normal file
14
workflows/scan-watchlist-icm/_config/trade_plan_template.md
Normal file
@@ -0,0 +1,14 @@
|
||||
# Trade Plan Template
|
||||
|
||||
**Symbol:**
|
||||
**Side:** (Long/Short)
|
||||
**Entry Zone:**
|
||||
**Stop:**
|
||||
**Targets:** T1: , T2: , T3:
|
||||
**Time Horizon:**
|
||||
**Rationale:**
|
||||
**Invalidation Condition:**
|
||||
**Options Structure (if applicable):**
|
||||
- Credit spread strikes:
|
||||
- Bid-ask spread:
|
||||
- Time decay:
|
||||
@@ -0,0 +1,55 @@
|
||||
AAPL
|
||||
UPS
|
||||
UBER
|
||||
TSM
|
||||
TSLS
|
||||
TSLA
|
||||
TGT
|
||||
TAN
|
||||
SQQQ
|
||||
SPY
|
||||
SPX
|
||||
SOXL
|
||||
SEDG
|
||||
SBUX
|
||||
RUN
|
||||
ROKU
|
||||
RIVN
|
||||
RBLX
|
||||
QQQ
|
||||
PYPL
|
||||
PLTR
|
||||
PINS
|
||||
PANW
|
||||
NVDA
|
||||
NKE
|
||||
NFLX
|
||||
MU
|
||||
MSFT
|
||||
META
|
||||
KRE
|
||||
INTC
|
||||
HOOD
|
||||
HD
|
||||
GOOGL
|
||||
GOOG
|
||||
FSLR
|
||||
FDX
|
||||
ETSY
|
||||
ENPH
|
||||
DIS
|
||||
DE
|
||||
DDOG
|
||||
CRWD
|
||||
CRM
|
||||
COST
|
||||
COIN
|
||||
CAT
|
||||
BITO
|
||||
BABA
|
||||
BA
|
||||
ARKK
|
||||
AMZN
|
||||
AMD
|
||||
AFRM
|
||||
ADBE
|
||||
|
15
workflows/scan-watchlist-icm/stages/00_clarify/CONTEXT.md
Normal file
15
workflows/scan-watchlist-icm/stages/00_clarify/CONTEXT.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# Stage 00 Clarify: Ask Key Questions
|
||||
|
||||
## Inputs
|
||||
- (none) - Start of workflow
|
||||
|
||||
## Process
|
||||
Ask the user the following key questions to configure the scan:
|
||||
1. Long only, or long + short? (Specify bias: long, short, or both)
|
||||
2. Time horizon: 0DTE intraday scalps, or day/swing holds?
|
||||
3. Asset class focus: Equities only, or include ETFs (SPY/QQQ/TAN/SOXL/SQQQ/KRE) in the confluence review?
|
||||
|
||||
Record the answers in a markdown file.
|
||||
|
||||
## Outputs
|
||||
- user_preferences.md -> output/
|
||||
@@ -0,0 +1,18 @@
|
||||
# Stage 01 Broad Filter: Initial Ticker Screening
|
||||
|
||||
## Inputs
|
||||
- Layer 4 (working): ../00_clarify/output/user_preferences.md
|
||||
- Layer 3 (reference): shared/cha-martin-watchlist.ms.csv
|
||||
|
||||
## Process
|
||||
1. Read user preferences to determine bias, time horizon, and asset class focus.
|
||||
2. Load the full ticker list from the watchlist CSV.
|
||||
3. Establish market context by pulling snapshot data for SPY and QQQ to determine the day's regime (trend, range, key levels).
|
||||
4. Perform a batch scan (using Finviz or equivalent) filtering for:
|
||||
- Price within ~3% of the 50-day MA
|
||||
- Consolidation/base pattern or pullback setup
|
||||
- Above/below VWAP context
|
||||
5. Record the resulting shortlist of candidates (expected 10-15 tickers) for further analysis.
|
||||
|
||||
## Outputs
|
||||
- shortlist.md -> output/
|
||||
@@ -0,0 +1,18 @@
|
||||
# Stage 02 Confluence Analysis: Evaluate Candidates
|
||||
|
||||
## Inputs
|
||||
- Layer 4 (working): ../01_broad_filter/output/shortlist.md
|
||||
- Layer 3 (reference): shared/cha-martin-watchlist.ms.csv (full ticker list for reference)
|
||||
|
||||
## Process
|
||||
For each ticker in the shortlist, evaluate the following confluence factors:
|
||||
1. Daily chart structure: load symbol, D timeframe to assess trend, price vs 50MA/200MA, support/resistance zones, base/consolidation patterns.
|
||||
2. Intraday setup: load 3-min or 5-min chart to examine VWAP relationship, pre-market gap vs overnight range, opening range break potential.
|
||||
3. Volume profile: check volume indicator for above-average volume confirming move or thin volume suggesting trap.
|
||||
4. Options flow / unusual activity: use MCP → ttg-options chain snapshot to spot unusual call/put volume, max pain, gamma exposure.
|
||||
5. Relative strength: visually compare chart to sector/market to see if holding while sector/market sells.
|
||||
|
||||
Record analysis for each ticker, noting which factors align.
|
||||
|
||||
## Outputs
|
||||
- confluence_analysis.md -> output/
|
||||
23
workflows/scan-watchlist-icm/stages/03_trade_plan/CONTEXT.md
Normal file
23
workflows/scan-watchlist-icm/stages/03_trade_plan/CONTEXT.md
Normal file
@@ -0,0 +1,23 @@
|
||||
# Stage 03 Trade Plan: Construct Detailed Trade Plans
|
||||
|
||||
## Inputs
|
||||
- Layer 4 (working): ../02_confluence_analysis/output/confluence_analysis.md
|
||||
- Layer 3 (reference): _config/trade_plan_template.md (optional template for structuring plans)
|
||||
|
||||
## Process
|
||||
1. From the confluence analysis, select the top 2-4 tickers with the strongest confluence.
|
||||
2. For each selected ticker:
|
||||
- Load the ticker on AI chart with overlays: VWAP, 50 EMA, key support/resistance levels.
|
||||
- Identify the exact entry zone, stop level, and target levels (T1/T2/T3).
|
||||
- Draft a trade plan including:
|
||||
* Symbol, side, entry zone, stop, targets, time horizon
|
||||
* Rationale: confluence factors that align (daily structure + intraday trigger + flow confirmation)
|
||||
* What invalidates it: the one condition that kills the thesis
|
||||
- Given preference for credit spreads, evaluate options structure:
|
||||
* Credit spread strikes (defined risk, collect premium)
|
||||
* Bid-ask spread width (< $0.25 preferred for scalps)
|
||||
* Time decay working in your favor
|
||||
3. Compile all trade plans into a single document.
|
||||
|
||||
## Outputs
|
||||
- trade_plans.md -> output/
|
||||
@@ -0,0 +1,20 @@
|
||||
# Stage 04 Summary Card: Produce Final Scan Summary
|
||||
|
||||
## Inputs
|
||||
- Layer 4 (working): ../03_trade_plan/output/trade_plans.md
|
||||
- Layer 4 (working): ../02_confluence_analysis/output/confluence_analysis.md (for sitting-on-hands list)
|
||||
- Layer 4 (working): ../01_broad_filter/output/shortlist.md (optional reference)
|
||||
|
||||
## Process
|
||||
1. Review the trade plans and confluence analysis to rank setups by confluence score.
|
||||
2. Select the top 3-5 setups.
|
||||
3. For each selected setup, extract:
|
||||
- Setup type (e.g., pullback, breakout, etc.)
|
||||
- Entry zone, stop level, target levels (T1/T2/T3)
|
||||
- Key confluence factors that aligned
|
||||
- Risk level (based on stop distance, volatility, etc.)
|
||||
4. Compile a "sitting on hands" list: tickers from the shortlist that showed some promise but lacked a decisive edge (note reasons).
|
||||
5. Produce a structured summary card in markdown format.
|
||||
|
||||
## Outputs
|
||||
- summary_card.md -> output/
|
||||
66
workflows/tool-catalog-maintainer/CONTEXT.md
Normal file
66
workflows/tool-catalog-maintainer/CONTEXT.md
Normal file
@@ -0,0 +1,66 @@
|
||||
# Tool: Tool Catalog Maintainer
|
||||
|
||||
## Purpose
|
||||
Create and maintain a `README.md` catalog for a user-specified directory containing subfolders of tools, prompts, scripts, docs, workflows, skills, or other reusable resources.
|
||||
|
||||
The README is a living catalog. It should improve over time as new subfolders are added and existing ones are updated. Future humans and LLM agents will refer to this README to decide which resource to use for a request.
|
||||
|
||||
Invoke this tool when the user asks to:
|
||||
|
||||
- create a catalog README for a folder of tools/resources
|
||||
- update an existing catalog after tools change
|
||||
- summarize available prompts, scripts, docs, workflows, or reusable assets
|
||||
- make a directory easier for LLMs to navigate
|
||||
- document a collection of reusable tools
|
||||
- generate or refresh an index for agent skills, prompts, scripts, references, or workflows
|
||||
|
||||
## Inputs
|
||||
|
||||
| Layer | Path | Required | Notes |
|
||||
| --- | --- | --- | --- |
|
||||
| Layer 4 working | `<target-folder>/` | Yes | The folder the user points to. It should contain one or more direct subfolders to catalog. |
|
||||
| Layer 4 working | `<target-folder>/README.md` | No | Existing catalog to preserve and improve when present. |
|
||||
| Layer 3 reference | `tools/tool-catalog-maintainer/references/catalog-format.md` | Yes | Defines the recommended README structure and cataloging rules. |
|
||||
|
||||
## Process
|
||||
|
||||
1. Confirm the target folder exists.
|
||||
2. Inspect the target folder's direct subfolders. Treat each direct subfolder as one catalog entry unless the user's request says otherwise.
|
||||
3. For each subfolder, inspect enough contents to understand its purpose and use:
|
||||
- `README.md`, `CONTEXT.md`, `SKILL.md`, `PROCEDURE.md`, and other Markdown files
|
||||
- prompt files
|
||||
- scripts such as `.py`, `.sh`, `.js`, `.ts`, `.rb`, `.go`, etc.
|
||||
- config files such as `package.json`, `pyproject.toml`, `requirements.txt`, `uv.lock`, `.env.example`
|
||||
- `references/`, `docs/`, `assets/`, `output/`, or similarly named support folders
|
||||
4. Do not deeply read generated outputs, large dependency folders, archives, or binary assets unless they are necessary to identify the tool.
|
||||
5. If a catalog README already exists, preserve useful existing content and improve it rather than replacing blindly.
|
||||
6. Write for future LLM consumption:
|
||||
- use explicit folder names and paths
|
||||
- state when to use each tool
|
||||
- name key files and entry points
|
||||
- call out setup requirements and cautions
|
||||
- prefer structured tables plus short per-tool sections
|
||||
7. Create or update `<target-folder>/README.md` using the format in `references/catalog-format.md`.
|
||||
8. Verify the README covers every relevant direct subfolder and does not invent capabilities not supported by the inspected files.
|
||||
|
||||
## Outputs
|
||||
|
||||
Update or create:
|
||||
|
||||
```text
|
||||
<target-folder>/README.md
|
||||
```
|
||||
|
||||
The README should be a durable catalog, not a one-time summary.
|
||||
|
||||
## Verify
|
||||
|
||||
Before finishing, verify that:
|
||||
|
||||
- the target folder exists
|
||||
- every relevant direct subfolder is represented in the catalog
|
||||
- each entry has a purpose and “when to use” guidance
|
||||
- key files or entry points are listed where known
|
||||
- setup or dependency notes are included when visible
|
||||
- existing README content was preserved when useful
|
||||
- unsupported claims were avoided
|
||||
21
workflows/tool-catalog-maintainer/README.md
Normal file
21
workflows/tool-catalog-maintainer/README.md
Normal file
@@ -0,0 +1,21 @@
|
||||
# Tool Catalog Maintainer
|
||||
|
||||
This folder contains the `tool-catalog-maintainer` ICM tool/agent skill.
|
||||
|
||||
## Start here
|
||||
|
||||
- Agent operating contract: [`CONTEXT.md`](CONTEXT.md)
|
||||
- Agent Skills adapter: [`SKILL.md`](SKILL.md)
|
||||
- Catalog README format rules: [`references/catalog-format.md`](references/catalog-format.md)
|
||||
|
||||
## Intent
|
||||
|
||||
Use this tool to create or update a living `README.md` catalog for a target folder of tools, prompts, scripts, docs, workflows, skills, or reusable resources.
|
||||
|
||||
Example request:
|
||||
|
||||
```text
|
||||
Use tool-catalog-maintainer on tools/
|
||||
```
|
||||
|
||||
`CONTEXT.md` is the source of truth for how the tool runs. Keep this README as a short landing page only.
|
||||
52
workflows/tool-catalog-maintainer/SKILL.md
Normal file
52
workflows/tool-catalog-maintainer/SKILL.md
Normal file
@@ -0,0 +1,52 @@
|
||||
---
|
||||
name: tool-catalog-maintainer
|
||||
description: Creates and maintains a README.md catalog for a directory containing subfolders of tools, prompts, scripts, docs, workflows, skills, or reusable resources. Use when asked to catalog, index, summarize, or update documentation for a folder of tools so humans or LLMs can quickly choose the right resource.
|
||||
---
|
||||
|
||||
# Tool Catalog Maintainer
|
||||
|
||||
## Purpose
|
||||
|
||||
Create and maintain a `README.md` catalog for a user-specified directory containing subfolders of tools, prompts, scripts, docs, workflows, skills, or other reusable resources.
|
||||
|
||||
The README is a living catalog. It should improve over time as new subfolders are added and existing ones are updated. Future humans and LLM agents will refer to this README to decide which resource to use for a request.
|
||||
|
||||
## When to use
|
||||
|
||||
Use this skill when the user asks to:
|
||||
|
||||
- create a catalog README for a folder of tools/resources
|
||||
- update an existing catalog after tools change
|
||||
- summarize available prompts, scripts, docs, workflows, or reusable assets
|
||||
- make a directory easier for LLMs to navigate
|
||||
- document a collection of reusable tools
|
||||
- generate or refresh an index for agent skills, prompts, scripts, references, or workflows
|
||||
|
||||
## Workflow
|
||||
|
||||
1. Confirm the target folder exists.
|
||||
2. Inspect the target folder's direct subfolders. Treat each direct subfolder as one catalog entry unless the user says otherwise.
|
||||
3. For each subfolder, inspect enough contents to understand its purpose and use:
|
||||
- `README.md`, `CONTEXT.md`, `SKILL.md`, `PROCEDURE.md`, and other Markdown files
|
||||
- prompt files
|
||||
- scripts such as `.py`, `.sh`, `.js`, `.ts`, `.rb`, `.go`, etc.
|
||||
- config files such as `package.json`, `pyproject.toml`, `requirements.txt`, `uv.lock`, `.env.example`
|
||||
- `references/`, `docs/`, `assets/`, `output/`, or similarly named support folders
|
||||
4. Do not deeply read generated outputs, dependency folders, archives, or binary assets unless needed to identify the tool.
|
||||
5. If a catalog README already exists, preserve useful existing content and improve it rather than replacing blindly.
|
||||
6. Write for future LLM consumption:
|
||||
- use explicit folder names and paths
|
||||
- state when to use each tool
|
||||
- name key files and entry points
|
||||
- call out setup requirements and cautions
|
||||
- prefer structured tables plus short per-tool sections
|
||||
7. Create or update `<target-folder>/README.md` using `references/catalog-format.md`.
|
||||
8. Verify the README covers every relevant direct subfolder and does not invent unsupported capabilities.
|
||||
|
||||
## Output
|
||||
|
||||
Create or update:
|
||||
|
||||
```text
|
||||
<target-folder>/README.md
|
||||
```
|
||||
0
workflows/tool-catalog-maintainer/output/.gitkeep
Normal file
0
workflows/tool-catalog-maintainer/output/.gitkeep
Normal file
@@ -0,0 +1,60 @@
|
||||
# Catalog README Format
|
||||
|
||||
Use this reference when creating or updating a catalog README for a folder of tools, prompts, scripts, docs, workflows, or other reusable resources.
|
||||
|
||||
## Recommended README shape
|
||||
|
||||
```markdown
|
||||
# Tool Catalog
|
||||
|
||||
This README catalogs the tools and resources in this directory. It is intended for humans and LLM agents to quickly identify what is available and when to use it.
|
||||
|
||||
## Catalog
|
||||
|
||||
| Tool / Folder | Purpose | Key Files | When to Use |
|
||||
| --- | --- | --- | --- |
|
||||
| `example-tool/` | Brief summary of what it does. | `README.md`, `script.py` | Use when... |
|
||||
|
||||
## Tools
|
||||
|
||||
### `example-tool/`
|
||||
|
||||
**Purpose:**
|
||||
Describe what this tool/resource does in 1–3 sentences.
|
||||
|
||||
**Contents:**
|
||||
- `README.md` — usage notes and overview
|
||||
- `script.py` — command-line entry point
|
||||
- `references/` — supporting documentation
|
||||
|
||||
**Use when:**
|
||||
Describe the requests or situations where an agent should choose this tool.
|
||||
|
||||
**Setup / dependencies:**
|
||||
List visible install steps, runtimes, package managers, API keys, or “None noted.”
|
||||
|
||||
**Notes:**
|
||||
Include cautions, output locations, maintenance hints, or limitations.
|
||||
|
||||
## Maintenance Notes
|
||||
|
||||
When adding or updating a tool folder, update this README with:
|
||||
|
||||
- purpose
|
||||
- key files and entry points
|
||||
- usage guidance
|
||||
- setup requirements
|
||||
- notable changes or cautions
|
||||
```
|
||||
|
||||
## Cataloging rules
|
||||
|
||||
- Prefer accuracy over completeness. If purpose is unclear, say so and name the files inspected.
|
||||
- Do not claim a tool can do something unless the files support it.
|
||||
- Keep the table compact; put detail in the per-tool sections.
|
||||
- Include exact relative paths so future agents can load the right files quickly.
|
||||
- Distinguish source files from generated `output/` artifacts.
|
||||
- Mention whether a tool is prompt-only, script-driven, documentation-only, or a workflow.
|
||||
- If a folder has its own README, use it as the primary source but still verify key files.
|
||||
- Preserve useful existing catalog notes during updates.
|
||||
- Remove stale entries only when the corresponding folder is gone or clearly obsolete.
|
||||
Reference in New Issue
Block a user