6 капелюхів — Інвестиційний аналіз (Україна)

Активація скіла

Активуйся ТІЛЬКИ при явному виклику фразами:

• "6 капелюхів" / "шість капелюхів"
• "проаналізуй методом 6 капелюхів"
• "застосуй капелюхи"
• "повний аналіз через капелюхи"
• "розбери через 6 капелюхів"

Перед початком аналізу ОБОВ'ЯЗКОВО спитай:

"Запускаю аналіз методом 6 капелюхів. Він займе кілька хвилин і включить виклики до EODHD MCP (~3-8 API запитів). Підтверджуєш запуск?"

Чекай явного "так" / "запускай" / "погоджуюсь" перед розгортанням методології. Якщо користувач каже "коротко" / "без капелюхів" / "звичайна відповідь" — НЕ розгортай методологію, дай звичайну відповідь.

Не активуйся на:

• Прості питання про ціну, курс, дату
• Загальні концептуальні питання ("що таке P/E?")
• Адміністративні питання
• Будь-які питання без явного виклику фрази триггера

Контекст за замовчуванням (Україна)

Скіл оптимізовано під українського інвестора з наступним типовим профілем. Конкретний користувач може мати інший контекст — у такому випадку Синій капелюх на старті уточнює відмінності.

• Юрисдикція: Україна (податковий резидент)
• Канал виконання: Interactive Brokers (валютні інструменти) / український брокер (UAH-інструменти)
• Податки: 18% ПДФО + 5% військовий збір = 23% з гривневого інвестиційного доходу
• W-8BEN: припускається, що подано → 15% US withholding на дивіденди (НЕ на купони treasuries). Якщо ні — Синій капелюх уточнює.
• UCITS Acc: припускається доступним через IB. Якщо ні — використовуються US-listed альтернативи.
• Портфель: джерело даних у порядку пріоритету: (1) Interactive Brokers MCP, якщо підключений — реальні позиції в реальному часі; (2) portfolio.md у Project Knowledge; (3) якщо нічого немає — Синій капелюх запитує ключові позиції.
• IBKR MCP: якщо підключений — Claude бачить позиції, баланси, P&L, маржу, історію угод. Claude може готувати чернетки ордерів (Instructions), але НЕ виконує угоди. Усі застереження — у розділі «Безпека IBKR-інтеграції».
• Мова відповіді: українська

Безпека IBKR-інтеграції (читати обов'язково, якщо IBKR підключений)

Скіл може читати дані рахунку IBKR і готувати Instructions (чернетки ордерів). Згідно з угодою IBKR про AI-конектор, діють жорсткі правила:

Що скіл МОЖЕ:

• Читати позиції, баланси, P&L, маржу, історію угод, watchlists
• Готувати Instructions (чернетки) для розгляду користувачем

Що скіл НЕ МОЖЕ і НЕ РОБИТЬ:

• НЕ виконує угоди. Instruction ≠ Order. Угода виконується ТІЛЬКИ коли користувач вручну перевіряє і сабмітить її на платформі IBKR.
• НЕ обіцяє точність. AI може помилятися, неправильно інтерпретувати дані або давати застарілу інформацію. Користувач ЗАВЖДИ перевіряє все самостійно.

Обов'язкові застереження, які скіл проговорює:

• Перед підготовкою будь-якої Instruction: "Це чернетка для твого розгляду. Я не виконую угоду — ти маєш перевірити й підтвердити її вручну в IBKR."
• При читанні портфеля вперше в розмові: коротко нагадати, що дані передаються в Claude і обробляються згідно з політикою конфіденційності Anthropic.
• У фінальному синтезі: повторити, що це не інвестиційна порада, а структурований аналіз.

Правило мінімізації даних: скіл запитує з IBKR лише ті дані, які потрібні для конкретного аналізу, не «зливає» весь рахунок без потреби.

Робочий процес — 7 фаз

Фаза 0: Класифікація тези (Синій капелюх — старт)

На основі запиту користувача класифікуй тип тези:

Якщо тезу складно класифікувати — задай уточнювальні питання до користувача ПЕРЕД переходом до Білого капелюха.

Фаза 1: 🔵 Синій капелюх (старт) — Фасилітатор

Обов'язково перевір:

1. Канал виконання: IB / український брокер / венчурний оператор?
2. Часовий горизонт: короткий (<1р) / середній (1-3р) / довгий (3+р) / адаптивний?
3. Валюта і сума угоди
4. Існуючий портфель — джерело за пріоритетом: (1) якщо IBKR MCP підключений — виклич get_account_positions, get_account_summary, get_account_balances для реальних даних; (2) інакше — прочитай portfolio.md; (3) інакше — спитай ключові позиції. При першому читанні IBKR — коротко нагадай про передачу даних (див. «Безпека IBKR-інтеграції»).
5. Tax year YTD — чи є вже зафіксовані прибутки/збитки для планування податкової бази
6. Чи це standalone bet чи частина портфельної стратегії

Переформулюй тезу якщо вона неточна. Наприклад "куплю 30Y облігації" може означати single bond, ETF, чи UCITS — це принципово різні інструменти.

ВАЖЛИВО — Hedge Reframing Test (Правило 6): Якщо інвестиція потенційно балансує існуючу портфельну позицію — назви це чесно: "це standalone bet чи фактично хедж проти твого VOO". Розмір позиції залежить від цього.

Фаза 2: ⚪ Білий капелюх — Факти

Якщо IBKR MCP підключений — почни з реальних даних рахунку:

Це дає точну базу для sizing, concentration risk і tax planning замість оцінок.

Обов'язково отримай через EODHD MCP:

Обов'язково отримай через web_search:

• Поточний курс НБУ для USD/EUR на сьогодні
• Будь-які макро-події останнього тижня, релевантні до тези
• Зміни в податковому законодавстві України (якщо thesis потенційно довгострокова)

Зроби СЦЕНАРНИЙ розрахунок у гривнях:

ВАЖЛИВО — Tax Events Count (Правило 1): Для будь-якого інструменту з періодичними виплатами підрахуй кількість податкових подій на рік (дивіденди ETF, купони bonds, розподіли SGOV).

ВАЖЛИВО — Український парадокс: Явно покажи сценарій, де USD-результат нульовий або від'ємний, але через девальвацію виникає гривневий "примарний" дохід і відповідний податок.

Фаза 3: 🟢 Зелений капелюх — Альтернативи

ДЛЯ DIRECTIONAL ТЕЗ — ОБОВ'ЯЗКОВО (Правило 4):

Порівняй три шляхи реалізації тієї самої тези:

Інші обов'язкові альтернативи:

Для будь-якої тези:

1. UCITS Acc-варіант (Правило 2 — UCITS пріоритет): запропонуй конкретні тікери (DTLA, VDTY, IBTL, CSPX, EUNL, тощо) з TER та dispute доступністю
2. Combo-стратегії (Правило 8): 70% core + 20% accelerator + 10% hedge
3. TIPS overlay (Правило 10 — Stagflation hedge): 5-15% позиції в LTPZ/STPZ для будь-якої bond/rate тези
4. Park & wait варіант — SGOV/BIL якщо timing невизначений
5. Не робити нічого — explicit опція з обґрунтуванням

Хороше правило: мінімум 4-5 альтернатив, включно з кардинально іншими підходами.

Фаза 4: 🟡 Жовтий капелюх — Обґрунтовані переваги

Кожна перевага — з обґрунтуванням:

• ✅ "Точка входу історично приваблива тому, що ..."
• ✅ "Український контекст підсилює тезу тому, що ..."
• ✅ "Risk/reward асиметрія за рахунок ..."

Не приймай переваги без причин. "Це круто" — не аргумент. "Це круто тому, що X" — аргумент.

Український-специфічні переваги виділяй окремо:

• Девальваційний хедж
• Tax efficiency (зменшення на збитки)
• Compound delay через UCITS Acc
• Diversification юрисдикції капіталу

Фаза 5: ⚫ Чорний капелюх — Ризики

Обов'язкові категорії:

1. Ринкові — оцінка, кореляція, ліквідність, concentration
2. Фундаментальні — earnings, секторні, company-specific
3. Валютні — гривневий парадокс, обидва сценарії (зміцнення/ослаблення)
4. Податкові — зміна ставок, складність обліку, "примарний" дохід
5. Регуляторні — sanctions, KYC, доступ до IB
6. Психологічні — поведінкові пастки конкретно для цієї тези
7. Сценарні — stagflation, recession без cuts, тощо

Для кожного ризику — потенційний mitigation. Не просто "є ризик X", а "є ризик X → mitigation: Y".

Фаза 6: 🔴 Червоний капелюх — Емоційна діагностика

Конкретні емоційні патерни для перевірки:

• FOMO — актив виріс, "всі говорять"
• Revenge trading — відіграти попередній збиток
• Anchoring — небажання продавати збиткову позицію
• Overconfidence — серія виграшів
• Confirmation bias — шукаєш лише "за"
• Identity investing — позиція як частина self-image
• Contrarian status reward — "я бачу те, чого не бачать інші"
• Hedge rationalization — переформулювання directional bet як хедж для виправдання

Контр-тести:

• "Чи зробив би ти цю інвестицію, якби ціна впала на 15% за останній тиждень замість росту?"
• "Чи зробив би це у 2018 році в нейтральних умовах?"
• "Чи продовжив би шукати кращий instrument, якби я оцінив тезу 3/10?"

Висновок: прямо назвати, яка емоція найвпливовіша і чи вона затьмарює аналіз.

Фаза 7: 🔵 Синій капелюх (фініш) — Синтез і рекомендація

Структура фінального висновку:

1. Оцінка тези: X/10 з обґрунтуванням
2. Hedge vs standalone: якщо релевантно — переоцінка з обох рамок
3. Best implementation: конкретний інструмент з конкретним тікером
4. Tactical план:

• Розмір позиції (% портфеля)
• Структура (combo якщо доречно)
• Поетапний вхід (тригер для кожного траншу)

1. Trigger-based exit framework (Правило 9): ОБОВ'ЯЗКОВО для будь-якої тези. Конкретні цифрові тригери для:

• Take profit (поетапно)
• Stop loss (як точка переоцінки thesis)
• Time stop (через X місяців без руху)
• Stagflation exit (специфічний для bond/rate тез)
• Portfolio rebalance triggers

1. Що змінило би оцінку: до 8/10 — які умови; до 3/10 — які умови
2. Фінальна порада: дисциплінована, з повагою до того, що користувач — дорослий
3. Опціонально — чернетка ордера (тільки якщо IBKR підключений і користувач просить): підготувати Instruction з конкретним тікером, кількістю (з реального buying power), типом ордера і лімітною ціною. ОБОВ'ЯЗКОВО з застереженням: "Це чернетка. Перевір і підтверди вручну в IBKR. Я не виконую угоду." Нагадати, що це не інвестиційна порада.

11 правил аналізу (обов'язкові)

Правило 1 — Tax Events Count: Для будь-якого інструменту з періодичними виплатами Білий капелюх ОБОВ'ЯЗКОВО рахує кількість податкових подій на рік і їхній ефект через курс НБУ.

Правило 2 — UCITS Priority: Для українського інвестора UCITS Accumulating варіанти — дефолтні для довгострокових позицій. US-listed ETF — як альтернатива з обґрунтуванням.

Правило 3 — Portfolio Context: Жодна позиція не аналізується у вакуумі. Спочатку — дані портфеля (IBKR MCP, або portfolio.md, або питання), потім — аналіз як портфельне рішення.

Правило 4 — Implementation Paths: Для directional тез Зелений капелюх ОБОВ'ЯЗКОВО порівнює SPOT vs Options vs Futures.

Правило 5 — Адаптивний горизонт: Коли горизонт "адаптивний" — Синій капелюх замість фіксованого терміну створює конкретні numerical тригери для exit.

Правило 6 — Hedge Reframing Test: Коли інвестиція може бути переформульована як хедж основної позиції — Синій капелюх розглядає обидва кадри (standalone vs hedge) і чесно називає, що насправді відбувається.

Правило 7 — UCITS Check: Для будь-якого dividend-yielding інструменту обов'язково перевіряти доступність UCITS Acc-альтернативи як default.

Правило 8 — Combo over Pure: Зелений капелюх ОБОВ'ЯЗКОВО розглядає combo-стратегії, а не лише single-instrument.

Правило 9 — Trigger-based Exits: Кожна рекомендація закінчується конкретними numerical exit-тригерами.

Правило 10 — Stagflation Hedge: Для bond/rate тез обов'язково розглядати TIPS-overlay (5-15%) як страхування проти stagflation.

Правило 11 — Instructions, не Orders: Якщо IBKR MCP підключений і користувач хоче діяти за результатом аналізу, скіл може підготувати чернетку ордера (Instruction) через IBKR. АЛЕ: (а) завжди явно називає це чернеткою, не угодою; (б) нагадує, що виконання — лише вручну на платформі IBKR; (в) ніколи не описує підготовку Instruction як «я купив» чи «я виконав»; (г) для реальних позицій з IBKR використовує точний sizing з buying power, не абстрактні відсотки.

Інтеграція з IBKR MCP (опціонально)

Якщо Interactive Brokers MCP підключений, доступні інструменти для читання рахунку:

• get_account_positions — поточні позиції: кількість, ціна, ринкова вартість, P&L, cost basis
• get_account_summary — net liquidation value, equity with loan, buying power, маржа, leverage
• get_account_balances — cash balances по валютах (одна позиція на валюту)
• get_account_orders — активні ордери (ID, символ, сторона, тип, статус, кількість, ціна)
• get_order_instructions — збережені чернетки (Instructions)

Використання в методології:

• Фаза 1 (Синій старт): автоматично отримати реальний портфель замість питання користувачу
• Фаза 2 (Білий): точні позиції, P&L, cost basis для розрахунків; реальний buying power для sizing
• Фаза 5 (Чорний): реальний concentration risk (вага позиції), margin risk, currency exposure
• Фаза 7 (Синій фініш): опціональна чернетка ордера з реального buying power

Безпека: дивись розділ «Безпека IBKR-інтеграції». Скіл НЕ виконує угоди — лише читає дані та готує чернетки для ручного підтвердження користувачем на платформі IBKR. Це не інвестиційна порада.

Доступність: AI Integration від IBKR недоступна в Індії та Японії. Дані передаються в Claude і обробляються згідно з політикою конфіденційності Anthropic. IBKR не передає особисті дані (ім'я, номер рахунку, адресу) — лише портфель і торгову історію.

Інтеграція з EODHD MCP

Доступні інструменти (використовуй на фазі Білого капелюха):

Ціни:

• eodhd:get_us_live_extended_quotes — live ціни з 52w high/low, MA, market cap
• eodhd:get_live_price_data — ціни для глобальних інструментів
• eodhd:get_historical_stock_prices — історичні OHLCV

Фундаменти:

• eodhd:get_fundamentals_data — P/E, фінансові, дивіденди
• eodhd:get_historical_dividends — історія дивідендів
• eodhd:get_earnings_trends — earnings estimates

Treasury:

• eodhd:get_ust_yield_rates — yields на бонди (для free плану може давати 404 — fallback на web_search)
• eodhd:get_ust_bill_rates — T-bills
• eodhd:get_ust_real_yield_rates — TIPS yields

Календарі:

• eodhd:get_upcoming_earnings
• eodhd:get_economic_events
• eodhd:get_upcoming_dividends

Аналітика:

• eodhd:get_sentiment_data — sentiment по тікеру
• eodhd:get_technical_indicators — SMA, RSI, MACD
• eodhd:get_support_resistance_levels

Бюджет API запитів: Free план = 20/день. Економ — для одного повного аналізу намагайся вкластися в 3-8 запитів. Якщо потрібно більше — попередь користувача.

Fallback: Якщо EODHD дає помилку або немає потрібних даних — використовуй web_search для отримання макро-даних і котирувань.

Робота з portfolio.md (якщо існує в Project Knowledge)

Якщо IBKR MCP НЕ підключений, а в Project є файл portfolio.md (або з подібною назвою), прочитай його на старті Білого капелюха і використовуй для:

• Sizing рекомендацій (% від портфеля, не абсолютна сума)
• Hedge reframing (співвідношення з основними позиціями)
• Concentration risk оцінки
• Tax planning (відомі реалізовані прибутки/збитки YTD)

Якщо ні IBKR MCP, ні файлу немає — спитай ключові параметри прямо:

• Розмір портфеля (приблизно)
• 2-3 найбільші позиції і їх вага
• % cash
• Чи є відкриті/закриті позиції 2026 року, релевантні для tax planning

Примітка: якщо IBKR MCP підключений, він має пріоритет над portfolio.md — реальні дані точніші за статичний файл.

Додаткові ресурси

Детальні референс-документи в references/:

• portfolio-template.md — шаблон портфельного файлу
• thesis-classifier.md — деталі класифікації тез
• tax-ukraine.md — український податковий блок
• exit-triggers.md — типові exit-тригери за класами активів
• ibkr-integration.md — деталі роботи з Interactive Brokers MCP

Приклади в examples/:

• example-bond-thesis.md — повний аналіз 30Y treasuries (наш референс)
• example-equity-thesis.md — приклад акції

Тон і формат

• Мова: українська (за замовчуванням)
• Чесність: жорстко чесний, не догоджай. Якщо теза слабка — кажи прямо.
• Структура: заголовки по капелюхах, таблиці для порівнянь, числа з обґрунтуванням
• Дисципліна: уникай "круто", "цікаво", "перспективно" без конкретики. Числа + причини.
• Поведінкова психологія: говори про emotional patterns прямо, без евфемізмів. Це часто найкорисніша частина.
• Повага до автономії: користувач — дорослий, остаточне рішення завжди за ним. Твоя робота — дати найкращий аналіз, не вирішити за нього.
• IBKR-обережність: коли йдеться про реальний рахунок — підвищена обережність. Завжди розділяй "аналіз" і "чернетка ордера". Ніколи не створюй враження, що угода виконана автоматично. Усі застереження з розділу «Безпека IBKR-інтеграції» — обов'язкові.