Skip to content

docs: add PROBLEMS.md as the companion to CHANGELOG.md - #181

Merged
fig-ai-agent[bot] merged 1 commit into
mainfrom
docs/problems-md
Sep 10, 2026
Merged

docs: add PROBLEMS.md as the companion to CHANGELOG.md#181
fig-ai-agent[bot] merged 1 commit into
mainfrom
docs/problems-md

Conversation

@fig-ai-agent

@fig-ai-agent fig-ai-agent Bot commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Adds PROBLEMS.md alongside CHANGELOG.md — the changelog records what shipped, this records what is still broken, using the same [YYYY-MM-DD] sections.

Six entries, each with the evidence behind the claim and the owning tracker task:

id status problem
P-001 OPEN 5 workflow files do not parse (parser error listed per file)
P-002 BLOCKED 66 action refs unpinned; org policy rejects them
P-003 BLOCKED the App cannot write .github/workflows/ — isolated by a control push, not assumed
P-004 OPEN agent-core unverified against a live provider and Supabase
P-005 OPEN new-crystalcastle's bare feat branch blocks feat/* pushes
P-006 RESOLVED the cmd_new template-comment bug fixed in PR #179

CHANGELOG.md gains a one-line pointer to the new file. No workflow file is touched.

The changelog records what shipped; there was nowhere recording what is still
broken. PROBLEMS.md fills that gap with the same [YYYY-MM-DD] sections, so a
date section here pairs with the same section there.

Six entries, each with its evidence:

- P-001 OPEN    five workflow files do not parse (with the parser error each)
- P-002 BLOCKED 66 action refs unpinned; org policy rejects them
- P-003 BLOCKED the App cannot write .github/workflows/ (isolated by a
                control push, not assumed)
- P-004 OPEN    agent-core unverified against a live provider and Supabase
- P-005 OPEN    new-crystalcastle's bare 'feat' branch blocks feat/* pushes
- P-006 RESOLVED the cmd_new template-comment bug fixed in PR #179

Each entry names the owning tracker task and the command behind the claim.
CHANGELOG.md gains a pointer to the new file.

No workflow file is touched.
@fig-ai-agent
fig-ai-agent Bot merged commit 598b0e0 into main Sep 10, 2026
3 of 8 checks passed
@fig-ai-agent
fig-ai-agent Bot deleted the docs/problems-md branch September 10, 2026 13:09
fig-ai-agent Bot added a commit that referenced this pull request Sep 10, 2026
)

CHANGELOG.md gains the three PRs that were not yet recorded (#180 changelog
PR, #181 PROBLEMS.md, #182 the task close-out), so the [2026-09-10] section
matches what actually merged.

PROBLEMS.md gains two entries:

- P-007 OPEN — new-crystalcastle CI: five workflows run
  'pip install -r requirements.txt' but the repo has no root requirements.txt
  (only scripts/errorlog-generator/requirements.txt). Evidenced by run
  34471137096. Separately caused from P-002/the bad-SHA issue, so fixing SHAs
  alone will not turn that repo green.
- P-008 RESOLVED — TASK-20260910-004 had been stored in a file named
  example-task.md; renamed in PR #182.

New task TASK-20260910-006 owns P-007. It is blocked deliberately: whether the
right fix is a new root requirements.txt or repointing each workflow at the real
path depends on the intended project layout, and the two workflows may want
different files. Guessing would make CI pass while being wrong.

Tracker tests: 20 passed. No workflow file touched.

Co-authored-by: Fig Agent <agent@fig.local>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants