Skip to content

Progress Report - November 2025 #46

@innov8tor3

Description

@innov8tor3

Reporting
This report follows on from and succeeds two prior issues.

#37 noted the need for a Monthly Progress Report, and #31 noted a possible approach to converting GitHub Issues to Reporting.

How did we do?

What We Did Well
We discovered that Grok is able to read GitHub Issues, and GitHub Commits, but cant's read Comments attached to Issues, without a bit of prompting help. Once a code outline is provided Comments are available and can be used in a data stream.

Huge thanks to ShivamNox from the GitHub community for his speedy and spot on response.

Grok can see issue titles because they’re in the main issue object, but comments are separate. To include comments, Grok must fetch them

from:
GET /repos/{owner}/{repo}/issues/{issue_number}/comments

No extra links are needed; just ensure the repo is public and each issue’s comments endpoint is accessed. Using GitHub’s GraphQL API can fetch issues and all comments in one query for easier reporting.

What Could Go Better
This exploring took a while, mainly down to not knowing the technical landscape, and not quite knowing the right questions to ask in AI. It took human intervention to find the answer on Comments.

Commits Versus Issues
There is a logic leap between Issues, Comments and Commits, which we are still working through. We have devised a working classification to help with reporting. It's likely this classification applied manually to issues and reporting can assist with matching Web Page Production.

We can track actual Web page production through Commits. With scoped but not published Web pages, in Grok, project-engine is working through past Grok HTML, to make sure this has been picked up and translated across. Once in HTML format, AI like Grok can make much more sense, even with a high level of sprawling and "life" disjoint.

With Issue Completion, project-engine can and maybe should have a concluding and connecting HTML page embedded at conclusion to assist folk interested in exploring later down the line.

Are Issues Too Detailed?
Issues can often be at a very detailed level, and need summarising and maybe attaching to any Reporting strand. Understanding the shape of Issue work does have an impact on overall project progress, and can help explain why project Road Maps need to be reviewed and even adjusted, as project-engine has seen over the past reporting period. Pivoting can happen organically, and still needs to be tracked, monitored and action taken as needed.

This is an early attempted version of the November progress report. It is at Issue level and too granular, too sprawling, with not enough direction for folk to dive in.

How Can We Take Next Steps
An easy answer is to ask AI about the above, and typically that's Grok for project-engine.

This whole Issue and subsequent Monthly Report HTML will be a human version for this "End of November" progress report. It's not yet automated. We still aim to show progress and pivoting since the previous report, which was in fact back in September.

The timings and speed of project reporting need to improve, and this still needs more work. The question to resolve is the interplay between GitHub Commits and GitHub Issues, but we seem to be getting closer.

When publishing new reports, we need a GitHub archive of previous reports, and blog style "Previous" and "Next" linking for folk who want to follow along.

HTML Pages Waiting
Only three according to Grok. Various attempts have been made to make progress here, including integrating Issues and Grok activity, and these are fairly well aligned. The HTML still needs inspection, decisions and perhaps deployment.

To Follow
In succeeding Comments:

  • UX
  • Quests
  • Traction
  • Technology

Metadata

Metadata

Assignees

No one assigned

    Labels

    reportingTypically to do with audience engagement

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions