In short:
ak-interview-docsturns the vision, decisions and principles in your head into project docs, in your own words. It asks one turn at a time and writes right after each answer. There is no fixed next skill. It does not propose approaches (that isak-brainstorm) and does not read code to write docs (that isak-docs).
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it when you already have a vision, decisions or principles in your head but have not written them down: the README does not say what the project is for, the team just settled something and needs a place to record why, or you want to write a principles or strategy doc one part at a time. You do not need it when you want AI to propose approaches (use ak-brainstorm) or want docs generated from code (use ak-docs).
flowchart LR
A["Ideas in your head"] --> B["ak-interview-docs"]
B --> C["README, decision file, principles doc"]
B --> D["Want AI proposals: ak-brainstorm"]
B --> E["Want docs from code: ak-docs"]
C --> F["Stops when you end the interview"]Two modes and two writing rules:
| Concept | Question | Example |
|---|---|---|
| Vision mode | What is this project for, and what have you decided? | Rewrite the direction part of the README, record the decision "PostgreSQL only". |
| Structured doc mode | Which standalone doc do you want to write? | Team principles, a quarterly strategy, an evaluation framework. |
| Write right after each answer | Where in the doc does what you just said belong? | Once you answer, it rereads the related part, inserts your words, then asks the next question. |
| Only record what you have settled | Is this a decision or still an idea you are weighing? | You say "maybe we should use Redis" and it does not record a decision. You give 5 unnumbered items and it does not rank them for you. |
The argument is vision, a path to the doc to write, or a topic. If the request fits both modes, it asks you one short question to pick before writing anything.
Sample prompt for the direction part of a README:
/ak-interview-docs vision
Project <project name>. I want the README to say clearly who the project is for and what it does not do.
Ask me in short batches, do not write ideas for me.This skill has no flags.
Below is the detailed version: the run flow, 5 situations with prompts, the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-interview-docs: interview you, write your words into docs" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-interview-docs". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-interview-docs
