Frame ML Problem
Write ## Modeling decisions in journal/JOURNAL.md. The table
is the contract. This skill does not declare a learner and does
not evaluate one.
Human-facing prose
Details: setup-workspace references/human_facing_prose.md.
Journal rows describe this dataset. Do not name the skills
framework, the CLI, or a splitter class in the table. Questions
use data-science language — not skill ids, G-* names, or the
wrapper CLI.
Procedure
-
Run
python -m skore_skills status. Ifstatus.setup.pendingis non-empty andstatus.skills.setup-ml-projectis true, loadsetup-ml-projectand stop. Do not start this skill. When it returns, continue. Do not load it again on this turn. If that skill is not installed, name the pending pieces in one line and stop. Do not inventgit init, scaffold, orenv init. Ifstatus.setup.envorstatus.setup.workspaceisdeclined, stop in one line. A declinedgitoreditableis not asked again; continue. Ifdata_analysisismissingandexplore-ml-datais installed, AskUserQuestion: explore first (default) or continue from facts the user stated. Explore loadsexplore-ml-dataand stops. Do not invent dataset facts. Do not ask this again oncedata_analysisispresentorskipped. -
Run
python -m skore_skills frame show. When the user is changing a locked constraint and named one decision, do not add--reviseand do not treatproceedas the end of the turn. Show this command once, in a fence. The only sentence for it is: That command drops that one recorded decision. Then runframe showwith no--revise.python -m skore_skills frame clear --cell <key>Ask the replacement in this message, the way step 5 asks a missing decision. Do not say that
frame showwill ask it. When the named decision is the comparison metric and the message does not state the new value, say that metric role, prediction goal, and folds stay filled. Then name the experiment file from the workspace state and say it still uses the previous metric and is not run, and that the next build or evaluate rewrites it after the table is complete again. The last line is: The comparison metric is MAE. Which metric replaces it? Nothing follows that line. When the named decision is the prediction goal and the message already states the new value, write that value. Metric role and the comparison metric are unanswered. Status isdraft. Ask those two in this message. Do not write Statuslocked. Otherwise, if the message already states the new value, write it and ask only the decisions that are still empty. Do not ask Modify / Keep / Stop. Do not say the new value waits until next turn. Do not loadmodel-ml-pipelineor git-close on this turn. When they are changing a constraint and did not name a decision, AskUserQuestion one pick among the filled decisions (skipn/a) and stop. Do not also ask for a typed answer. Do not--reviseand do not edit the journal on that turn. JSONactionis authoritative. Do not invent a menu. If the command is missing or exits without JSON, follow Fallback below. Do not open another reference. Do not guess candidates. -
stop— say the JSONreasonand stop. -
ask/uncovered— follow Fallback below, including the table written in this message and the Status rule there. Say the reuse and change lines, and say there is no splitter translation. Do not loadbuild-ml-pipeline. Stop this turn. -
ask/missing_keys— read each distinctreferenceinquestionsonce before asking. Do not open any other file underreferences/. Ask every key inmissingin one message. For a question that hascandidates, those are the options. Whencandidatesis absent, ask for the value the reference describes. Draw on three sources, and only what they actually say: the EDA report, free-form text that came with the data if any is present (notes, a dictionary, or a README beside the raw files), and facts the user stated. If none of that text is present, do not invent it. When one of them already states the fact, quote it in the question. Write every Value the user answered in this turn. Do not rename the Variable column. Do not stop after the first decision. When the deployment makes other rows inapplicable, set those rows ton/ain the same edit. Horizon, gap, and time role aren/aunless deployment is time. Generalize-to isn/aunless deployment is groups. A fold count of1is one train/test split drawn from a single table. When the EDA report, the text shipped with the data, or the user already names a separate training table and test table, offer using that split in the folds question and writepredefinedif they choose it. Do not offer it otherwise. Do not writeprefitin the table. Do not typeRevised on; only that command writes that date. If any key inmissingis still unanswered, set Status todraftonce any decision is filled, ask those keys, and stop. Do not invent their values. Do not set Status tolocked. Do not ask to confirm the table. If the write fills every required decision, set Status tolockedin that same edit, notdraft. Runpython -m skore_skills frame showagain in this turn. Onproceed, say the reuse and change lines, then follow step 8. Onask/set, write Statuslockedonly, say those lines, runframe showagain, and follow step 8. If thatframe showstill returnsmissing_keys, the table was not complete: ask those keys and stop, and leave Statusdraft. Reuse and change lines, quoting JSONcontextin 2–4 lines: these choices are reused for the rest of the experiment so models stay comparable, and any one of them can be changed by naming it (for example the comparison metric). Do not say "lock" in those lines. Do not AskUserQuestion. -
When the user named one decision and Status is
draft, do not treatsetas accepting the table. Show the same fenced command for that decision and stop. Do not write the new value. Do not say any other decision was dropped. The command's JSON list of dropped keys is the record. Status staysdraft. That command stampsRevised on; do not type that date. The nextframe showasks only keys that are still empty or invalid. -
ask/set— the table was already complete and Status is stilldraft. Write Statuslockedonly. Say the reuse and change lines from step 5. Runframe showagain and follow step 8. Do not AskUserQuestion. The user sentence that opened this screen is not a choice.ask/reviseis not a user question. Do not present Modify / Keep / Stop. Ignore thosechoices. Drop the named decision and ask the replacement, as in step 2. -
proceed— the table is locked, and the user is not changing a named decision. If they are, step 2 already handled it. Iftranslationis null, say that this lock has no splitter translation. Do not loadbuild-ml-pipelineand do not return tomodel-ml-pipeline. Stop. Ifmodel-ml-pipelinedispatched this turn, return to that coordinator and stop. Do not start build, write a design note, or run the git close from here. If no experiment script exists and History has no running, done, or abandoned model row, andstatus.skills.model-ml-pipelineis true, load that skill and stop. Do not write a design note here. Do notgit end-turn. Otherwise runpython -m skore_skills git end-turn --stage implement. If JSONactionisinvoke, loadpersist-ml-gitonly ifstatus.skills.persist-ml-gitis true and stop. Otherwise loadtriage-ml-taskonly if that skill is installed.
Live preview
After any turn that changes journal/JOURNAL.md (filled
decisions, Status, that command, or lock), coalesce all edits,
then, when policy.site is true and export-ml-site is
installed, run python -m skore_skills site build --if-stale
before the next question or stop. In that message, say the
website has been updated and paste the file:// line from
that output verbatim. Do not name
journal/JOURNAL.md. policy.site
null or false does not enable or build the site. A
read-only frame show with no Markdown change does not build.
Stop conditions
- Do not write Python, a pipeline, a test, or a design note.
- Do not put a class name or a constructor argument in the journal.
TimeSeriesSplit,KFold,GroupKFold, andgap=stay out of the table. - Do not re-ask a key that is absent from
missing. - Do not add an option that is absent from
candidates. - Do not open a reference the JSON did not name. When the command is missing, follow Fallback below instead of opening a file.
- A recorded decision changes when that command drops it, then
filling it like any missing one. A complete fill sets Status
to
lockedagain. Do not ask Modify / Keep / Stop. - That command is the only journal edit that drops a recorded
decision, and only for the decision the user named. It stamps
Revised on; do not type that date. Do not rewriteexperiments/,audit/, or a report in this skill. - After that decision is dropped, do not run an existing experiment script. Say that it still uses the previous splitter and metric. Show the command once, in a fence. The next build or evaluate rewrites it after the table is complete again.
Fallback
Use this when frame show is missing, or when the problem is not
classification, regression, or multi-output regression. Do not
open any other file under references/. Do not invent the closed
candidate menu.
Tell the user, in a few lines, that the closed menu does not cover this case, so the comparison has to be written in words. Ask one question: what would count as a better result, and what is an honest baseline. Draw on the EDA report, free-form text that came with the data if any is present, and facts they stated. Quote a fact those sources already give. If that text is absent, do not invent it.
Write the table in this same message:
- Prediction goal:
uncovered - Metric: the comparison, in their words, or empty if they did not state it
- Baseline note: the baseline, in their words, or empty if they did not state it
- Every other decision row:
n/a, unless they already stated a value
Do not use placeholders. Do not leave the table for a later
message. Status is locked only when both the comparison and the
baseline are already stated. Otherwise Status is draft. The
words lock, modify, and stop stay out of the message.
Do not name a splitter class or write code. Say these choices are reused for the rest of the experiment so models stay comparable, and that any one of them can be changed by naming it. There is no splitter translation.
If they say it is actually classification or regression, write that
goal instead of uncovered and stop. Do not set Status to locked.
The next frame show uses the closed menu.
If the command is missing, there is no JSON. The same write uses the same lines. There is no splitter translation.


