2 15 min

Analyst: collect your content

Role: Analyst
Outcome: Your content file and a short spec
Time box: 15 minutes

The Analyst collects what your site will say: who you are, what you built, where people find you. It writes all of it into one file, then a short plan for the Roles after it.

This Block ends with two files. The content file, site/content.json, contains all your content; every section of your site is drawn from it. The spec, docs/spec.md, is a short written plan: what the site is for, who it is for and what a visitor should do. A photo of you is optional.

Start the Analyst

In Antigravity IDE, start a new chat in the agent panel (the + button at the top of the panel).
Check the model name under the chat box: it says Gemini 3.8 Flash. If not, click it and pick Gemini 3.8 Flash.

Then type:

Agent chat

Start the Analyst step.

The Analyst starts with a short message: about ten minutes, at most eight questions, one at a time. It gives you three ways to start, and asks you not to type your phone number or home address.

The agent asks before it runs a command. Read the command first. Allow commands that start with node tools/ or git: they are the ones on these pages, such as node tools/check-content.mjs. For anything else, first ask it: "What does this command do, and why?"

Give it your content

Pick the way that suits you. All three end with the same files.

Open your LinkedIn profile in Chrome.
Click see more in your About section, so the whole text shows.
Select everything from your name down to the end of your profile: Experience, Education, Licenses & certifications, Volunteering, Skills and Languages. Copy it.
Paste it into the agent chat and send it.

The Analyst reads it and asks only about what is missing, usually your projects with their GitHub links and the email address visitors may see.

Your site can show your certifications and the events in Volunteering too, so copy all of it.

LinkedIn shortens long lists of jobs on the page. For a complete copy, use LinkedIn's PDF instead: on your profile, click More (on some profiles Resources), then Save to PDF, and give it to the Analyst as in the CV file tab.

Drag your CV file, for example a PDF, into the agent chat. The PDF that LinkedIn makes of your profile works too.
Send it.

Keep the CV file outside your portfolio folder. It contains your phone number and address, and everything in that folder can become public.

If the Analyst cannot read the file, open the CV, select all its text, copy it and paste it into the chat instead.

Type:

Agent chat

interview

The Analyst asks up to eight short questions, one at a time, for example about your goal, your projects and your links. Answer in a sentence or two.

Answer its questions

The first question is about the language of your site. English is the default: say English, or name another language.

The second question is about your site's goal: a job, freelance clients, speaking invitations or community. Your answer decides what your site shows first, and the Analyst writes it into your spec. In the same question, it asks whether you are available now, or from when.

After that it asks only about gaps: what your text did not tell it. Say skip to any question you would rather leave out. It asks each question once.

For each project it needs a name, one sentence and the link to its GitHub repository. A project without a GitHub link does not go into the projects list.

For the top of your page, it looks for a pitch: one sentence of at most 160 characters on what you offer. For example: "I build fast, accessible websites for small shops." It also notes your availability, your city and the languages you speak.

Events and certifications from your text become widgets: small sections your site shows only when your content file has their data. A dated "Now" list, a few honest numbers or a project told as a case study can follow later.

Read it back

When the questions are done, the Analyst writes your two files. It runs node tools/check-content.mjs until the file is ready. That command compares your content file with the schema (the list of what the content file may contain) and looks for a phone number or a postal address:

What the content check prints

site/content.json is ready: it matches the schema and has no phone number or postal address.

Then it sends one message that explains both files in plain words. It names your headline and pitch, your availability, city and languages, your goal, your projects, your links, your work, education and skills, and your certifications and events. It also says your site's language, and what it left out and why. Lines in the spec that start with "(a guess)" are the Analyst's guesses, for example what a visitor should do.

Today it also adds this workshop to your site. DevFest becomes an event, with this workshop as your session in it. A line at the bottom of your page says, for example: "Built with AI agents at DevFest Milano, October 10, 2026. No trackers. Fonts served from this site." Want either one gone? Say so.

It also starts the preview (your site on your own laptop) with node tools/preview.mjs. Open the address it gives you, such as http://localhost:8000, in Chrome. You see your name and your content on the page, still in the plain look of the template. Your own look comes later: the Designer writes it down, the Developer builds it.

Add your photo (optional)

In its read-back message, the Analyst also asks whether you want a photo of you on your site. It is optional: your site works without one too. A real, well-lit photo of your face works best, not one made by AI.

Copy the photo file into your portfolio folder:

In Finder, click your photo and press Cmd+C. Press Cmd+Shift+H (or menu Go → Home), open portfolio and press Cmd+V.

In File Explorer, click your photo and press Ctrl+C. Click into the address bar, type %USERPROFILE%\portfolio, press Enter, then press Ctrl+V.

In Files, click your photo and press Ctrl+C. Open Home, then portfolio, and press Ctrl+V.

Tell the Analyst the file's name and, in a few words, what the photo shows. For example: "me.jpg, smiling in front of a bookshelf." Those words become the alt text: they describe the photo for people who cannot see it.

The Analyst runs the photo tool on your file: node tools/photo.mjs me.jpg. It makes a small, square copy, site/assets/photo.webp, without the photo's hidden data, such as where it was taken. It says Your photo is ready.

Reload the preview in Chrome: your photo shows at the top of your page. Is your face cut in the square? Crop the photo, copy it in again and give the Analyst its name. Then delete the photo you copied into your portfolio folder, as the tool tells you. It still has its hidden data, and your site needs only site/assets/photo.webp.

The Analyst ends by sending you on: "The Analyst is done. Start a fresh chat and ask for the Designer: it asks you a few questions about your style and writes your personal Stitch prompt." If you gave it a CV file, it first reminds you to move that file out of your repo folder.

If something goes wrong

Ask your agent first. Start a fresh chat and type the question below. The agent reads your repo and tells you what is done and what comes next. Got an error message? Paste it into the chat, and it explains it.

Agent chat

Where am I?

The Analyst asks two questions in one message, or more than eight

Fix: answer the first one and say "One question at a time, please." If it keeps going, say "Write the files with what you have."

The agent starts designing or building in the same chat

Cause: the agent skipped ahead.

Fix: say "Stop. Only the Analyst in this chat." Then start a fresh chat for the next Role.

The photo tool cannot read your photo

Cause: iPhones save photos as HEIC files, which the tool cannot read. Or the file name has a typo.

Fix: save the photo as JPEG first. On a Mac, open it in Preview, choose File → Export and pick JPEG. On Windows, open it in Photos, choose Save as and pick JPEG. Give the Analyst the new file's name, spelled exactly.

My CV file is inside the portfolio folder

Fix: move it out of the folder, for example to your Documents folder:

In Finder, press Cmd+Shift+H (or menu Go → Home), then open portfolio. Drag the CV file onto Documents in the sidebar.

In File Explorer, click into the address bar, type %USERPROFILE%\portfolio and press Enter. Drag the CV file onto Documents in the left pane.

In Files, open Home, then portfolio. Drag the CV file onto Documents in the sidebar.

Fell behind?

When the Analyst Block's time is up and you are not done, jump to its checkpoint. A checkpoint (the finished state of this Block) brings your site to where the room is. It keeps your own content file, design brief and spec.

First stop the agent in your old chat, if it is still working: click the stop button in the agent panel. Otherwise it can keep changing files after the checkpoint has run.

Then, in Antigravity IDE, open a terminal (the window for typing commands) with the menu Terminal → New Terminal. It opens in your portfolio folder. Paste this command (Cmd+V on a Mac, Ctrl+V on Windows, Ctrl+Shift+V on Linux) and press Enter:

Terminal · same on Mac, Windows and Linux

node tools/checkpoint.mjs analyst

It lists, file by file, what it kept and what it changed. The last lines tell you what to do next: start a fresh chat and ask for the Designer. If it says Nothing to change, you were already there.

Or let the agent run it for you. Start a fresh chat and type:

Agent chat

Catch me up: the room just finished the Analyst block.

No content of your own yet? Then your site keeps the sample person, Ada Example, with a grey drawing in place of a photo, so you can follow the next Blocks. The output says still the sample person, or Nothing to change: both are fine. Add your own content with the Analyst later, at home.

Use the Block that has just ended, not the one that starts now.