Flexideo Průvodce

View saved version →

---
name: create-flexideo-project
description: Založí nový Flexideo projektový prostor, když uživatel chce začít projekt nebo analýzu a ještě nemá připravené Project Memory.
---

# Založení Flexideo projektu

Nejprve rozliš, zda už uživatel má projekt nebo self-service draft. Dostupné projekty
ověř přes open_project bez project_id; pro existující projekt použij jeho skutečné project_id.
Nevytvářej náhradní projekt, pokud jde o pokračování nebo obnovu.

Ve veřejném self-service režimu začíná nový projekt na Projects portálu stejného
prostředí jako připojené MCP (produkce https://projects.flexideo.cloud/,
vývoj https://projects-dev.flexideo.cloud/). Uživatel tam dokončí přihlášení,
přijetí podmínek a založení draftu. Server přidělí project_id; nikdy jej nevymýšlej.
Na webu může rovnou dokončit přípravu a otevřít projekt. Potom převezmi stejné ID
nebo jej ověř přes open_project bez project_id a pokračuj open-flexideo-project.

Pokud už draft existuje a uživatel chce dokončit přípravu v chatu, použij
start_project_provisioning se skutečným project_id, source=self_service a
ownership_mode=FLEXIDEO_MANAGED. Vytvoř stabilní idempotency_key a při opakování
stejného pokusu jej zachovej. Přímé založení bez draftu používej pouze v prostředí,
které tuto cestu výslovně podporuje. DRAFT_PROJECT_REQUIRED znamená návrat na
Projects portál, nikoli opakované pokusy s novým klíčem.

První veřejné vydání používá úložiště spravované Flexideem. Nenabízej uživateli
CLIENT_OWNED jako dostupnou alternativu, dokud není pro konkrétní prostředí
výslovně povolena. V povolené CLIENT_OWNED cestě předej bezpečný authorization_url,
po dokončení vybírej jen repository_id z ověřeného seznamu přes
select_project_repository. Nikdy nevyžaduj GitHub token, repository URL ani heslo.
Pokud uživatel výslovně určí název repozitáře, předej repository_name přesně;
jinak ponech výchozí odvození služby.

Stav ověř přes get_provisioning_status; přerušený tok obnov přes
resume_project_provisioning. Při ztrátě přístupu použij reconnect_project_repository
pro stejný repozitář. Po READY načti get_analysis_context stejného project_id a
pokračuj open-flexideo-project a start-faam-baseline. Požadovaný tools contract
je 0.11. FAAM analýza se tímto vstupním postupem nemění.

## Načtení metodiky podle hostitele

Společná metodika: `../../references/method.md`. Načti ji s nativní dovedností,
nebo použij obsah dodaný přes get_analysis_context; MCP obsah není důkaz nativní instalace.
Pro známý projekt načti na začátku kola get_analysis_context. Již načtený kontext téhož
kola využij i při přechodu do této dovednosti. known_guidance_revision a known_skill
předej jen pro skutečně načtený obsah; po ztrátě kontextu je vynech.
Další potřebnou dovednost dočti přes get_faam_guidance. Rutinně neopakuj snapshot/resume.
Běžné podporované kroky ulož přes commit_analysis_turn dle společné metodiky;
server přidá souhrn sezení a checkpoint. Samostatné schvalovací a stavové operace zachovej.
Průběhové i závěrečné zprávy piš jazykem uživatele.

View saved version →

---
name: manage-faam-evidence
description: Ukládá a posuzuje důkazy, předpoklady, inference, rozhodnutí a otevřené otázky ve FAAM Project Memory, včetně zdrojů a lidských potvrzení.
---

# Evidence a rozhodnutí

Využij get_analysis_context načtený pro toto kolo a dočti jen chybějící dokumenty. Respektuj aktuální revision, project_id a
method_version; pravidla konfliktů a idempotence jsou v run-faam-analysis.

append_evidence ukládá title, source, content, volitelné confidence/rationale a evidence_type:
fact, user_assumption, model_inference nebo imported_hypothesis. I fact vzniká jako
unverified. Nevolej následnou klasifikaci jen pro stejné označení inference či doplnění skóre, které lze uložit rovnou. Při klasifikaci použij classify_evidence s evidence_id, evidence_type,
confirmation_status, rationale a volitelným confidence 1–10. Skóre vyjadřuje odhad
jistoty, není kalibrovanou pravděpodobností a samo nic nepotvrzuje.

confirmed vyžaduje evidence_type=fact a explicitní human_approval(statement,
volitelný confirmed_at). Čas výroku předej jen ze známého zdroje s pásmem; neznámý čas vynech, neodhaduj. Serverový recorded_at znamená čas záznamu, nikoli čas výroku. Zaznamenej, co přesně člověk potvrdil a z jakého zdroje. Změnu původní
hypotézy na fakt vysvětli v rationale; původní obsah a historie musí zůstat dohledatelné.
rejected použij pro vyvrácený podklad. Důkaz bez metadata je legacy/unverified.
Pro čtení použij list_documents a read_document; načti obsah i .metadata.json.

Rozhodnutí zapisuj record_decision se status proposed/accepted/rejected/superseded a
rationale. Accepted vyžaduje skutečné doložené lidské rozhodnutí; technické oprávnění
zápisu nenahrazuje business souhlas. Nahrazení accepted rozhodnutí proveď novým accepted
záznamem s supersedes; server ověří předchůdce a označí jej superseded v témže commitu.

Chybějící informace řeš create_open_question(question, why_it_matters, blocking).
Blokaci zvol pouze pokud bez odpovědi nelze pokračovat v analýze. Podmínky budoucího pilotu či nasazení ukládej neblokující, lze-li dál analyzovat. Po zjištění odpovědi
použij resolve_question(answered) s odpovědí a zdrojem. Pro uzavření bez odpovědi použij
closed a doložený důvod změny relevance. Pouhé rozhodnutí otázku automaticky neuzavírá.
Nesnižuj blokaci ani nevytvářej náhradní otázku jen kvůli obejití stavové brány.

## Načtení metodiky podle hostitele

Společná metodika: `../../references/method.md`. Načti ji s nativní dovedností,
nebo použij obsah dodaný přes get_analysis_context; MCP obsah není důkaz nativní instalace.
Pro známý projekt načti na začátku kola get_analysis_context. Již načtený kontext téhož
kola využij i při přechodu do této dovednosti. known_guidance_revision a known_skill
předej jen pro skutečně načtený obsah; po ztrátě kontextu je vynech.
Další potřebnou dovednost dočti přes get_faam_guidance. Rutinně neopakuj snapshot/resume.
Běžné podporované kroky ulož přes commit_analysis_turn dle společné metodiky;
server přidá souhrn sezení a checkpoint. Samostatné schvalovací a stavové operace zachovej.
Průběhové i závěrečné zprávy piš jazykem uživatele.

View saved version →

---
name: open-flexideo-project
description: Otevře existující Flexideo projekt a obnoví práci z autoritativního Project Memory snapshotu.
---

# Otevření Flexideo projektu

Pokud uživatel uvedl project_id, otevři právě tento projekt. Jinak použij open_project
bez ID a nech jej vybrat, pokud je výsledků více.

Načti get_analysis_context; současně získáš metodiku i úplný kontext obnovy z jednoho headu. Pouze další
potřebné části dočti přes get_context nebo read_document se stejným headem. Nečti celý
repozitář a neodvozuj stav z historie chatu. Sděl aktuální revizi, stav baseline, stav
analýzy a doporučený krok.

Před pokračováním rozliš resume_status READY / STALE / MISSING podle společné
metodiky. Načtený vision_index je zásobník budoucích záměrů, nikoli další verze
Current Truth; recent_work_log je pouze chronologie pro orientaci při navázání. U READY obnov goal, task, done_when, presentation_mode, pending_question_ids, pending_batch_id a rozpočet kola;
stav projektu a skutečné blokace mají přednost před textem next_step. U STALE/MISSING
nejprve rekonstruuj rozpracovanou práci z uložených podkladů, bez domnělého souhlasu.
Samotné otevření projektu nic nezapisuje. Ohlášení revize není dokončená obnova.

Před každou mutací použij revision z kontextu jako expected_revision. Po mutaci pracuj
s novou vrácenou revision. Při konfliktu znovu načti get_analysis_context; nepřepisuj souběžnou změnu.

Ověř tools_contract flexideo-project-memory-mcp-tools/0.11. Při neúplném snapshotu
stránkuj list_documents s vráceným head_commit a načti relevantní read_document;
nevyvozuj nepřítomnost objektů z částečného seznamu. Pro řízení pokračování použij
run-faam-analysis, pro klasifikaci manage-faam-evidence a pro validace/výstupy
review-faam-memory. ANALYSIS_COMPLETED neznamená výzvu k automatickému znovuotevření.

## Načtení metodiky podle hostitele

Společná metodika: `../../references/method.md`. Načti ji s nativní dovedností,
nebo použij obsah dodaný přes get_analysis_context; MCP obsah není důkaz nativní instalace.
Pro známý projekt načti na začátku kola get_analysis_context. Již načtený kontext téhož
kola využij i při přechodu do této dovednosti. known_guidance_revision a known_skill
předej jen pro skutečně načtený obsah; po ztrátě kontextu je vynech.
Další potřebnou dovednost dočti přes get_faam_guidance. Rutinně neopakuj snapshot/resume.
Běžné podporované kroky ulož přes commit_analysis_turn dle společné metodiky;
server přidá souhrn sezení a checkpoint. Samostatné schvalovací a stavové operace zachovej.
Průběhové i závěrečné zprávy piš jazykem uživatele.

View saved version →

---
name: promote-offer-to-project
description: Přenese schválený význam konkrétního immutable offer releasu do Project Memory po explicitním rozhodnutí pokračovat v analýze nebo po podpisu smlouvy.
---

# Promoce nabídky do projektu

Vyžaduj konkrétní offer_id, release_id, cílový project_id a explicitní lidské
potvrzení události analysis_requested nebo contract_signed. Pro podepsanou smlouvu
vyžaduj také ne-tajnou smluvní referenci.

Nejprve použij validate_offer_promotion. Potom použij get_analysis_context cílového projektu a
shrň, co se přenese: schválený významový baseline, scope, výjimky, předpoklady a
provenance. Nepřenášej HTML, access seznam, interní review ani ostatní klientské složky.

promote_offer_to_project zavolej až po potvrzení člověkem. Zachovej stejný
idempotency_key při retry. Výsledné hypotézy nepřeváděj na fakta; následně spusť jejich
FAAM kontrolu.

Konkrétní immutable balíček načti get_offer_for_promotion a ověř jeho zdroj před
validate_offer_promotion. Po importu pokračuj start-faam-baseline; import ani
accepted rozhodnutí o převzetí nabídky není potvrzením všech jejích hypotéz.

## Načtení metodiky podle hostitele

Společná metodika: `../../references/method.md`. Načti ji s nativní dovedností,
nebo použij obsah dodaný přes get_analysis_context; MCP obsah není důkaz nativní instalace.
Pro známý projekt načti na začátku kola get_analysis_context. Již načtený kontext téhož
kola využij i při přechodu do této dovednosti. known_guidance_revision a known_skill
předej jen pro skutečně načtený obsah; po ztrátě kontextu je vynech.
Další potřebnou dovednost dočti přes get_faam_guidance. Rutinně neopakuj snapshot/resume.
Běžné podporované kroky ulož přes commit_analysis_turn dle společné metodiky;
server přidá souhrn sezení a checkpoint. Samostatné schvalovací a stavové operace zachovej.
Průběhové i závěrečné zprávy piš jazykem uživatele.

View saved version →

---
name: review-faam-memory
description: Ověřuje úplnost FAAM Project Memory, odkazy, připravenost k uzavření a tvoří review, blueprinty a milníkové výstupy z doložených podkladů.
---

# Review a výstupy FAAM

Využij get_analysis_context tohoto kola a podle potřeby stránkovaný list_documents
a read_document. Chybějící část ohraničeného výpisu není důkazem nepřítomnosti.

validate_memory má tři odlišné úrovně:
- structure: přítomnost povinných souborů;
- contract: také tvar stavu a rozpoznaných metadat;
- references: také existence a význam kontrolovaných vazeb.
Před potvrzením etapy použij references a řeš errors/missing; warnings o staré evidenci
znamenají neověřené podklady. Překročení limitu není úspěch. Validátor neprokazuje
věcnou pravdivost ani plnění business acceptance; to musí posoudit review a člověk.

write_artifact podporuje blueprint, architecture, review, report, prototype a other.
Blueprint a architekturu opři o potvrzenou baseline a doložená rozhodnutí. Výslovně
odděl varianty a otevřené hypotézy. Požadavek na změnu mimo scope vrať do analýzy.

Pro baseline nebo dokončení analýzy ulož review s kontrolou cíle, evidence, otázek,
rozhodnutí a acceptance. Potom bez dalšího mezilehlého zápisu proveď odpovídající
transition_analysis_state nebo close_epic. Stará review server odmítne;
po konfliktu znovu posuď změněný obsah a ulož aktualizované review.

Milestone Report: write_artifact(artifact_type=report, milestone=...) odkazuje na
existující checkpoint_id, related_decisions a případně epic_id. U Vision-backed delta
Epicu po promote_epic_to_current nejprve vytvoř nový checkpoint a z něj confirmed
milestone_type=epic-close; až potom lze Epic uzavřít. Tím historická podoba zůstane
připnutá a nový obsah je jediná Current Truth. Zvol milestone_type
baseline/analysis/solution-mvp/delivery-readiness/contracted-baseline/epic-close,
status draft/confirmed/superseded a audience internal/client. Klientské confirmed
výstupy mají confirmed_at a confirmed_by pouze na základě skutečného potvrzení.
Existence reportu sama nemění stav analýzy. Výstup pro klienta přizpůsob jeho cíli;
technické údaje MCP do něj patří jen tehdy, když jsou pro něj relevantní.

Na konci ulož append_session_log a commit_checkpoint dle run-faam-analysis a uveď
provedené kontroly, neověřené věci a další krok. Neoznačuj hotový návrh za nasazený systém.

## Načtení metodiky podle hostitele

Společná metodika: `../../references/method.md`. Načti ji s nativní dovedností,
nebo použij obsah dodaný přes get_analysis_context; MCP obsah není důkaz nativní instalace.
Pro známý projekt načti na začátku kola get_analysis_context. Již načtený kontext téhož
kola využij i při přechodu do této dovednosti. known_guidance_revision a known_skill
předej jen pro skutečně načtený obsah; po ztrátě kontextu je vynech.
Další potřebnou dovednost dočti přes get_faam_guidance. Rutinně neopakuj snapshot/resume.
Běžné podporované kroky ulož přes commit_analysis_turn dle společné metodiky;
server přidá souhrn sezení a checkpoint. Samostatné schvalovací a stavové operace zachovej.
Průběhové i závěrečné zprávy piš jazykem uživatele.

View saved version →

---
name: run-faam-analysis
description: Vede nebo obnovuje FAAM analýzu existujícího Flexideo projektu, řídí její stav, Epicy, otázky a předání dalšího sezení přes Project Memory MCP.
---

# Řízená FAAM analýza

Načti společnou metodiku `../../references/method.md` spolu s nativní dovedností,
nebo její kanonický obsah přes MCP. Obsah z MCP není důkaz nativní instalace.
Vyžaduj tools_contract flexideo-project-memory-mcp-tools/0.11 a method_version faam-1.0.0.
Při nesouladu zastav mutace a vysvětli potřebu aktualizace serveru/katalogu.

Pro nevybraný projekt použij open_project. Pro známý vybraný projekt začni kolo
get_analysis_context; načtený kontext využij i při přechodu mezi dovednostmi v témže kole.
Metodiku znovu načítej dle pravidel get_analysis_context ve společné metodice.
Rutinně neopakuj get_project_snapshot a get_resume_context. Chybějící podklady načítej
cíleně přes get_context nebo list_documents/read_document s head_commit.
READY dovoluje navázání; STALE/MISSING rekonstruuj dle společné metodiky.

## Metodický postup

- FAAM Core je solution-neutral: problém, potřeba, dopad, aktéři, informace, pravidla,
  výjimky, rizika a pozorovatelná acceptance bez předem zvolené technologie.
- Urči requested/effective Analysis Depth BASIC / STANDARD / DEEP podle metodiky.
  Question budget je samostatný limit 1–5, doporučeně 3. Režimy SINGLE / BATCH / BURST
  vybírej podle závislostí otázek; neseskupuj otázky jen pro snížení počtu volání.
- Poté proveď Solution Decision. STOP / NO CHANGE a jiná než Flexideo cesta jsou platné.
  accepted record_decision vyžaduje lidské rozhodnutí.
- Flexideo Delivery Planning aktivuj jen za podmínek společné metodiky.
- Baseline řeš přes start-faam-baseline. Po potvrzení použij start_analysis.
  EPIC-0001 již existuje před prvním příběhem. Po potvrzení baseline použij create_epic pro jeho cíl a acceptance; nejvýše jedna aktivní analýza. Další epic začíná vlastní draft baseline.
- Budoucí změny po Current Truth řeš přes create_vision / add_vision_note / review_vision / queue_vision / defer_vision / reject_vision a promote_vision_to_epic;
  dodrž oddělení hypotéz, evidence a schválení podle společné metodiky.

## Uložení běžného kola

Nejprve vypořádej uložené odpovědi a batch, potom podklady/návrhy a navazující otázky.
Částečnou odpověď nezaměňuj za úplné vyřešení. Nepřipisuj návrh modelu uživateli.
I kolo zakončené jen otázkami ulož před jejich předložením podle metodiky;
číslovaný seznam nenahrazuje BATCH. Nezodpovězené body potřebují OPEN identitu,
nejen zmínku v rozhodnutí, blueprintu či next_step. Respektuj výslovný zákaz zápisu.
Podmínka spuštění pilotu neblokuje automaticky další analýzu.

Použij commit_analysis_turn se steps, summary a závěrečným handoff podle společné metodiky.
Kroky: append_evidence, classify_evidence, resolve_question, resolve_question_batch,
create_open_question, create_question_batch, proposed record_decision, write_artifact bez milestone.
Použij odkazy `$step.field` dle metodiky; nehádej ID.
Server přidá audit, sezení a jediný checkpoint; neduplikuj je dalšími zápisy. Ověř receipt READY a verified_revision == revision;
Receipt platí pro uloženou revizi, ne pro budoucí head.

Identitu mutací, konflikty a opakování nejistých požadavků řeš dle společné metodiky.

## Samostatné řízené kroky

Zachovej stávající nástroje pro accepted rozhodnutí, baseline, stavové přechody, milníky,
Vize a Epicy. Neobcházej jejich brány atomickým kolem. Blokující otázky vyřeš před
resume_analysis; server analýzu sám neobnovuje. Reopen vyžaduje skutečný záměr uživatele.

Uzavření Epicu, přenos do Current Truth a dokončení analýzy proveď pouze
podle bran společné metodiky; review připrav přes review-faam-memory.

Human_approval a časy výroku eviduj přesně dle společné metodiky.
append_analysis_event použij pro událost mimo souhrn kola. Po samostatné mutaci ověř handoff.
Průběhové i závěrečné zprávy piš jazykem uživatele.

View saved version →

---
name: start-faam-baseline
description: Vytvoří nebo zkontroluje FAAM baseline, když projekt potřebuje potvrdit výchozí příběh, kontext, evidenci a otevřené otázky.
---

# FAAM baseline

Použij get_analysis_context, nebo již načtený kontext tohoto kola; nejprve
obnov nebo rekonstruuj uložený úkol dle společné metodiky. Další kontext dočti
přes get_context nebo read_document. Rozděl informace na:

- potvrzená fakta a jejich zdroje;
- uživatelské předpoklady;
- modelové inference;
- otevřené otázky.

Import nabídky je imported_hypothesis, dokud jej člověk samostatně nepotvrdí. Nabídka ani orientační řešení nejsou automaticky Analysis Model ani Solution Decision. Baseline zachycuje problém a kontext; sama neaktivuje Flexideo Delivery Planning.

Evidenci ukládej přes append_evidence, otázky přes create_open_question, souvislý
výchozí příběh přes update_context do baseline_story a rozhodnutí pouze přes
record_decision. Každá mutace musí mít stabilní idempotency key, aktuální revision,
skutečný důvod a metodickou verzi z kontextu.

Baseline neoznačuj za potvrzenou bez explicitního lidského potvrzení. Podklady a předání běžného kola ulož přes commit_analysis_turn dle společné metodiky;
update_context a schvalovací přechody zůstávají samostatné. Question budget je 1–5, doporučeně 3. Pro nezávislé otázky stejného kontextu můžeš použít BATCH 2–5; jinak SINGLE nebo BURST. Po dosažení budgetu vyhodnoť dostatečnost kola;
Souhrn kola zaznamená výsledek a důvod dalšího kola; append_session_log je potřebný jen
mimo atomický turn.

## Serverem řízené potvrzení

Ověř tools_contract flexideo-project-memory-mcp-tools/0.11. Evidence má explicitní typ;
append_evidence ji vytváří unverified. Pro potvrzení použij classify_evidence až po
skutečném souhlasu dle manage-faam-evidence. Zodpovězené otázky uzavři resolve_question.

Baseline je připravena k review, když je doložen problém, dopad, cílový výsledek,
rozsah a jeho hranice, hlavní aktéři, známá omezení a pozorovatelná kritéria úspěchu.
Neznámé nepřepisuj na fakta: pojmenuj je a rozliš, zda blokují smysluplnou baseline,
nebo mohou zůstat explicitní neblokující otázkou pro detailní analýzu. Nesnaž se
vyčerpat všechny implementační otázky před potvrzením příběhu.

Po doplnění baseline proveď validate_memory(level=references) a skutečné review,
ulož write_artifact(artifact_type=review) a bez mezilehlého zápisu zavolej
transition_analysis_state(action=review_baseline, review_document=<vrácená cesta>).
Teprve po explicitním lidském potvrzení použij confirm_baseline s human_approval
(statement, confirmed_at). Pak lze start_analysis. Textové „potvrzeno“ bez úspěšného
stavového nástroje není potvrzená baseline. Pokud se kontext změní, server baseline
vrátí do draft; proveď nové review a potvrzení. Podrobné pokračování: run-faam-analysis.

## Načtení metodiky podle hostitele

Společná metodika: `../../references/method.md`. Načti ji s nativní dovedností,
nebo použij obsah dodaný přes get_analysis_context; MCP obsah není důkaz nativní instalace.
Pro známý projekt načti na začátku kola get_analysis_context. Již načtený kontext téhož
kola využij i při přechodu do této dovednosti. known_guidance_revision a known_skill
předej jen pro skutečně načtený obsah; po ztrátě kontextu je vynech.
Další potřebnou dovednost dočti přes get_faam_guidance. Rutinně neopakuj snapshot/resume.
Běžné podporované kroky ulož přes commit_analysis_turn dle společné metodiky;
server přidá souhrn sezení a checkpoint. Samostatné schvalovací a stavové operace zachovej.
Průběhové i závěrečné zprávy piš jazykem uživatele.