From c6bcee5772a3dcc7ae42f7f6dd7f15e9c335ca92 Mon Sep 17 00:00:00 2001 From: redcatbaer Date: Sat, 7 Feb 2026 14:05:03 +0100 Subject: [PATCH 1/6] Updated the anubis2 theme to 1.3.2 pre-release 165. --- themes/anubis2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/themes/anubis2 b/themes/anubis2 index 821a5a1..134c3d0 160000 --- a/themes/anubis2 +++ b/themes/anubis2 @@ -1 +1 @@ -Subproject commit 821a5a1c6a2f15a68627037bd5ce390144237150 +Subproject commit 134c3d02bd4b0f802a4fcf26d8b2d051f288bfe2 From bbbb505aa510ecf66ae04e6cfc2b4734f29d7028 Mon Sep 17 00:00:00 2001 From: redcatbaer Date: Sat, 7 Feb 2026 14:16:47 +0100 Subject: [PATCH 2/6] Migrated Anubis2 theme configuration. --- config.yml | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/config.yml b/config.yml index 8a04203..433b16d 100644 --- a/config.yml +++ b/config.yml @@ -14,19 +14,19 @@ author: params: description: 'Home of the everything-is-code enthusiasts' - colorTheme: 'auto' - colorThemeSwitcher: 'true' - paginationSinglePost: true - toc: true - readMore: true - GoogleAnalytics: - enabled: false - social: - - id: 'github' - url: 'https://github.com/itsallcode' - - id: youtube - url: 'https://www.youtube.com/@itsallcode-org' mainSections: ['posts'] + anubis2: + colortheme: 'auto' + colorthemeswitcher: 'true' + enablesummary: true + enablereadmorebutton: true + paginationsinglepost: true + tocsthreshold: 300 + social: + - id: 'github' + url: 'https://github.com/itsallcode' + - id: youtube + url: 'https://www.youtube.com/@itsallcode-org' menu: main: From 66e3a9779343defb77d5e48c3e95525c73978177 Mon Sep 17 00:00:00 2001 From: redcatbaer Date: Tue, 12 May 2026 19:52:53 +0200 Subject: [PATCH 3/6] Added new post about OFT IntelliJ plugin and AI coding agent skills. --- .../2026/05/12/ide_integration_and_skills.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 content/posts/2026/05/12/ide_integration_and_skills.md diff --git a/content/posts/2026/05/12/ide_integration_and_skills.md b/content/posts/2026/05/12/ide_integration_and_skills.md new file mode 100644 index 0000000..efe72e0 --- /dev/null +++ b/content/posts/2026/05/12/ide_integration_and_skills.md @@ -0,0 +1,34 @@ +--- +title: "OFT in the IDE and Teaching AI Agents About Tracing" +date: "2026-05-12" +draft: false +author: sebastian +--- + +Two things happened recently that I think are worth mentioning: OFT got an IntelliJ plugin, and we added several skill files for AI coding agents. + +## The IntelliJ Plugin + +Running OFT during development should be as seamless as possible. While we have had build integration for a long time via our [Maven](https://github.com/itsallcode/openfasttrace-maven-plugin) and [Gradle](https://github.com/itsallcode/openfasttrace-gradle) plugins, many developers still found themselves dropping to the command line to check tracing results. That is fine for a final check before a commit, but during active development, it can interrupt your flow. + +The [IntelliJ plugin](https://github.com/itsallcode/openfasttrace-intellij-plugin) takes that friction out of the equation. You get the tracing results right in the IDE while you are editing, complementing the existing build-time checks. + +Head over to the repository for setup instructions: + +https://github.com/itsallcode/openfasttrace-intellij-plugin + +## Coding Agent Skills + +If you are working with an AI coding agent — and I suspect a growing number of us are — you have probably noticed that they need quite a bit of hand-holding when it comes to project-specific conventions. Explaining what a `dsn~some-feature~2` tag means every time you start a new session gets old fast. + +We added skill files to the OFT repository under [`.agents/skills`](https://github.com/itsallcode/openfasttrace/tree/main/.agents/skills). These are structured descriptions of OFT's specification item format, tracing conventions, and reverse-engineering capabilities that an AI agent can pick up as context. Think of it less as "AI magic" and more as a reference sheet you hand to a new team member — except the team member happens to be an LLM. + +The practical effect is twofold: +1. **Core Tracing Knowledge**: The agent can read and write spec items, understands the artifact type hierarchy, and knows how coverage tags work without you having to explain it from scratch. +2. **Reverse Engineering**: With the [`openfasttrace-reverse-specs`](https://github.com/itsallcode/openfasttrace/tree/main/.agents/skills/openfasttrace-reverse-specs) skill, the agent can even help you bootstrap your tracing. It can analyze your existing user guides, code, and tests to infer and draft missing system requirements and design specifications, making it much easier to add traceability to an existing project. + +## Convenience and Saving Time + +These additions boil down to the same thing: reducing friction. OFT is only useful if people actually run it, and the less ceremony involved, the more likely that happens. Whether you are using the build plugins, the command line, or the new IDE integration, the goal is to have tracing integrated into the places where developers actually spend their time. Adding the AI chat window as another interface for OFT just removes one more excuse to skip it. + +If you try either of them and run into issues, file a bug. Pull requests are welcome too. From bda36afd1d0e2103448b4f1186cf217d797977af Mon Sep 17 00:00:00 2001 From: redcatbaer Date: Tue, 12 May 2026 20:02:53 +0200 Subject: [PATCH 4/6] Updated Anubis2 theme. --- config.yml | 8 ++++---- themes/anubis2 | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/config.yml b/config.yml index 433b16d..bfa0ee6 100644 --- a/config.yml +++ b/config.yml @@ -17,16 +17,16 @@ params: mainSections: ['posts'] anubis2: colortheme: 'auto' - colorthemeswitcher: 'true' + enablecolorthemeswitcher: true enablesummary: true enablereadmorebutton: true - paginationsinglepost: true - tocsthreshold: 300 - social: + tocwordcount: 300 + socialicons: - id: 'github' url: 'https://github.com/itsallcode' - id: youtube url: 'https://www.youtube.com/@itsallcode-org' + paginationsinglepost: true menu: main: diff --git a/themes/anubis2 b/themes/anubis2 index 134c3d0..c9daeda 160000 --- a/themes/anubis2 +++ b/themes/anubis2 @@ -1 +1 @@ -Subproject commit 134c3d02bd4b0f802a4fcf26d8b2d051f288bfe2 +Subproject commit c9daeda0408e1b7aaf3164d4828d8e348055abee From 82236218e8f78debb3b441daefc92a9351e87365 Mon Sep 17 00:00:00 2001 From: redcatbaer Date: Tue, 12 May 2026 20:16:21 +0200 Subject: [PATCH 5/6] Use tag v1.6.0 for anubis2 submodule instead of a specific commit --- themes/anubis2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/themes/anubis2 b/themes/anubis2 index c9daeda..9c4e5b1 160000 --- a/themes/anubis2 +++ b/themes/anubis2 @@ -1 +1 @@ -Subproject commit c9daeda0408e1b7aaf3164d4828d8e348055abee +Subproject commit 9c4e5b169d285c4c008a754bbd361181407323ed From aabb04cf1a8926e3065190988c80897c7c18b381 Mon Sep 17 00:00:00 2001 From: redcatbaer Date: Tue, 12 May 2026 20:28:08 +0200 Subject: [PATCH 6/6] Updated Hugo and GitHub action versions. --- .github/workflows/gh-pages.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index d1014ea..9824165 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -7,7 +7,7 @@ on: pull_request: env: - HUGO_VERSION: "0.155.2" + HUGO_VERSION: "0.159.2" jobs: build: @@ -31,7 +31,7 @@ jobs: run: hugo --minify - name: Upload artifact - uses: actions/upload-pages-artifact@v3 + uses: actions/upload-pages-artifact@v5 with: path: ./public/ @@ -48,4 +48,4 @@ jobs: steps: - name: Deploy to GitHub Pages id: deployment - uses: actions/deploy-pages@v4 + uses: actions/deploy-pages@v5