Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-adopt

saas-adopt

Unverified

Brownfield audit of existing SaaS docs and code with a numbered Studio migration plan.

FileKindSize
SKILL.mdskill md5.3 KB
references/1-detect.mdmarkdown3.8 KB
references/2-format-audit.mdmarkdown9.9 KB
references/3-classify.mdmarkdown1.3 KB
references/4-migration-plan.mdmarkdown2.8 KB
references/5-summary.mdmarkdown2.5 KB
references/6-write.mdmarkdown3.5 KB
references/7-first-action.mdmarkdown3.3 KB

references/5-summary.md

View on GitHub
# /saas-adopt — Phase 5: Present Summary and Ask to Write

> Part of `/saas-adopt`. `SKILL.md` names when to read this file; the settings it
> resolved and the rules under its later headings still apply here.

## Phase 5: Present Summary and Ask to Write

Present a compact summary before writing:

```
## Adoption Audit Summary
Phase detected: [phase]
Engine: [configured / NOT CONFIGURED]
PRDs audited: [N] ([X] fully compliant, [Y] with gaps)
ADRs audited: [N] ([X] fully compliant, [Y] with gaps)
Stories audited: [N]

Gap counts:
  BLOCKING: [N] — template skills will malfunction without these fixes
  HIGH:     [N] — unsafe to run /saas-create-stories or /saas-story-readiness
  MEDIUM:   [N] — quality degradation
  LOW:      [N] — optional improvements

Estimated remediation: [X blocking items × ~Y min each = roughly Z hours]
```

Before asking to write, show a **Gap Preview**:
- List every BLOCKING gap as a one-line bullet describing the actual problem
  (e.g. `features-modules-index.md: 3 rows have parenthetical status values`,
  `adr-0002.md: missing ## Status section`). No counts — show the actual items.
- Show HIGH / MEDIUM / LOW as counts only (e.g. `HIGH: 4, MEDIUM: 2, LOW: 1`).

This gives the user enough context to judge scope before committing to writing the file.

If a prior adoption plan was detected in Phase 1, add a note:
> "A previous plan exists at `docs/adoption-plan-[prior-date].md`. The new plan will
> reflect current project state — it does not diff against the prior run."

Use `AskUserQuestion` (Render in Portuguese for PT-BR sessions, while processing internally in English):
- PT-BR (preferred when user interacts in Portuguese or locale is pt-BR):
  - Question: "Pronto para gravar o plano de adoção / migração?"
  - "(Recomendado) Sim — gravar `docs/adoption-plan-[date].md`"
  - "Ver a prévia completa do plano primeiro (não gravar ainda)"
  - "Cancelar — farei a migração manualmente"
- EN (fallback for English sessions):
  - Question: "Ready to write the migration plan?"
  - "(Recommended) Yes — write `docs/adoption-plan-[date].md`"
  - "Show me the full plan preview first (don't write yet)"
  - "Cancel — I'll handle migration manually"

*(Note: The agent processes the selected choice and produces all internal plan artifacts and code in English for maximum LLM performance).*

If the user picks "Show me the full plan preview", output the complete plan as a
fenced markdown block. Then ask again with the same three options.

---
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall