Document custom options

.agents/skills/writer/SKILL.md

@@ -3,7 +3,7 @@ name: writer
 description: >
   Write, edit, and restructure user-facing and developer-facing documentation.
   Use when asked to create/update docs such as `README.md`, `docs/**`, and
-  other Markdown documentation; 
+  other Markdown documentation, including keeping docs navigation data in sync;
   when drafting tutorials, guides, troubleshooting pages, or migration notes; and
   when improving inline API documentation (KDoc) and examples.
 ---
@@ -24,10 +24,36 @@ description: >
   - `docs/`: longer-form docs (follow existing conventions in that tree).
   - Source KDoc: API usage, examples, and semantics that belong with the code.
 
+## Keep docs navigation in sync
+
+- When adding, removing, moving, or renaming a page under
+  `docs/content/docs/<section>/`, keep the current version's matching
+  `sidenav.yml` in sync.
+- Use `docs/data/versions.yml` to identify the current documentation version for
+  that section. The current version is the entry with `is_main: true`; its
+  `version_id` maps to `docs/data/docs/<section>/<version_id>/sidenav.yml`.
+- Do not update historical version entries or their navigation files unless the
+  user explicitly asks to edit that historical version.
+- Map page files to `file_path` values relative to the current version's
+  `content_path`, without `.md`; `_index.md` maps to its directory path, such as
+  `01-getting-started/_index.md` -> `01-getting-started`.
+- Keep each `page` label aligned with the page frontmatter `title` unless the
+  existing navigation intentionally uses a shorter reader-facing label.
+- Preserve the existing ordering, nesting, keys, comments, and YAML quoting
+  style. Remove nav entries for deleted pages and update `file_path` values for
+  moved pages.
+- If a docs content change should not appear in navigation, say so explicitly in
+  the final response.
+
 ## Follow local documentation conventions
 
 - Follow `.agents/documentation-guidelines.md` and `.agents/documentation-tasks.md`.
 - Use fenced code blocks for commands and examples; format file/dir names as code.
+- In Markdown files, prefer footnote-style reference links for external `https://`
+  targets instead of inline links. Write readable body text like
+  `[label][short-id]`, then place the URL definition near the end of the file,
+  such as `[short-id]: https://example.com/long/path`. Keep reference IDs short
+  and descriptive. Inline links are still fine for local relative paths.
 - Avoid widows, runts, orphans, and rivers by reflowing paragraphs when needed.
 
 ## Make docs actionable
@@ -48,4 +74,3 @@ description: >
 
 - For code changes, follow `.agents/running-builds.md`.
 - For documentation-only changes in Kotlin/Java sources, prefer `./gradlew dokka`.
-

.github/workflows/build-on-ubuntu.yml

@@ -1,10 +1,10 @@
-name: Build under Ubuntu
+name: Ubuntu CI
 
 on: push
 
 jobs:
   build:
-    name: Build under Ubuntu
+    name: Build on Ubuntu
     runs-on: ubuntu-latest
 
     steps:

.github/workflows/build-on-windows.yml

@@ -1,11 +1,11 @@
-name: Build under Windows
+name: Windows CI
 
 on: pull_request
 
 jobs:
   build:
-    name: Build under Windows
     runs-on: windows-latest
+    name: Build on Windows
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/check-code-embedding.yml

@@ -1,10 +1,11 @@
-name: Check Code Embedding
+name: Code Embedding
 
 on:
   pull_request:
 
 jobs:
   build-embedded-code:
+    name: Build embedded code
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
@@ -19,6 +20,7 @@ jobs:
       - run: ./gradlew :docs:buildAll
 
   check-embedded-samples:
+    name: Match embedded and original code
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5

.github/workflows/ensure-reports-updated.yml

@@ -1,21 +1,21 @@
 # Ensures that the license report files were modified in this PR.
 
-name: Ensure license reports updated
+name: License Reports
 
 on:
   pull_request:
     branches:
       - '**'
 
 jobs:
-  build:
-    name: Ensure license reports updated
+  check:
+    name: Ensure license reports are updated
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v4
         with:
-          # Configure the checkout of all branches, so that it is possible to run the comparison.
+          # Configure the checkout of all branches so that it is possible to run the comparison.
           fetch-depth: 0
           # Check out the `config` submodule to fetch the required script file.
           submodules: true

.github/workflows/gradle-wrapper-validation.yml

@@ -1,4 +1,4 @@
-name: Validate Gradle Wrapper
+name: Gradle Wrapper validation
 on:
   push:
     branches:
@@ -9,7 +9,7 @@ on:
 
 jobs:
   validation:
-    name: Gradle Wrapper Validation
+    name: Validate Gradle Wrapper
     runs-on: ubuntu-latest
     steps:
       - name: Checkout latest code

.github/workflows/increment-guard.yml

@@ -1,15 +1,15 @@
 # Ensures that the current lib version is not yet published but executing the Gradle
 # `checkVersionIncrement` task.
 
-name: Check version increment
+name: Version Guard
 
 on:
   push:
     branches:
       - '**'
 
 jobs:
-  build:
+  check:
     name: Check version increment
     runs-on: ubuntu-latest
 

.github/workflows/publish.yml

@@ -6,7 +6,9 @@ on:
 
 jobs:
   publish:
+    name: Publish to Maven repositories
     runs-on: ubuntu-latest
+
     steps:
       - uses: actions/checkout@v4
         with:

.github/workflows/remove-obsolete-artifacts-from-packages.yaml

@@ -34,7 +34,7 @@ env:
 
 jobs:
   retrieve-package-names:
-    name: Retrieve the package names published from this repository
+    name: Retrieve package names
     runs-on: ubuntu-latest
     outputs:
       package-names: ${{ steps.request-package-names.outputs.package-names }}
@@ -54,7 +54,7 @@ jobs:
           echo "package-names=$(<./package-names.json)" >> $GITHUB_OUTPUT
 
   delete-obsolete-artifacts:
-    name: Remove obsolete artifacts published from this repository to GitHub Packages
+    name: Delete obsolete artifacts
     needs: retrieve-package-names
     runs-on: ubuntu-latest
     strategy:

.gitignore

@@ -39,6 +39,7 @@
 
 # Internal tool directories.
 .fleet/
+.junie/memory/
 
 # Kotlin temp directories.
 **/.kotlin/

.gitmodules

@@ -4,3 +4,6 @@
 [submodule "docs/_examples"]
 	path = docs/_examples
 	url = https://github.com/spine-examples/hello-validation
+[submodule "docs/_time"]
+	path = docs/_time
+	url = https://github.com/SpineEventEngine/time

.junie/guidelines.md

@@ -10,7 +10,7 @@ Also follow the Junie-specific rules described below.
 
 ## Junie Assistance Tips
 
-When working with Junie AI on the Spine Tool-Base project:
+When working with Junie AI on the Spine family of projects:
 
 1. **Project Navigation**: Use `search_project` to find relevant files and code segments.
 2. **Code Understanding**: Request file structure with `get_file_structure` before editing.

buildSrc/build.gradle.kts

@@ -137,8 +137,6 @@ val koverVersion = "0.9.1"
 /**
  * The version of the Shadow Plugin.
  *
- * `7.1.2` is the last version compatible with Gradle 7.x. Newer versions require Gradle v8.x.
- *
  * @see <a href="https://github.com/GradleUp/shadow">Shadow Plugin releases</a>
  */
 val shadowVersion = "9.4.1"

buildSrc/src/main/kotlin/io/spine/dependency/build/Dokka.kt

@@ -26,7 +26,6 @@
 
 package io.spine.dependency.build
 
-import io.spine.dependency.build.Dokka.GradlePlugin.id
 import io.spine.dependency.local.Spine
 
 // https://github.com/Kotlin/dokka

buildSrc/src/main/kotlin/io/spine/dependency/local/CoreJvmCompiler.kt

@@ -46,12 +46,12 @@ object CoreJvmCompiler {
     /**
      * The version used to in the build classpath.
      */
-    const val dogfoodingVersion = "2.0.0-SNAPSHOT.062"
+    const val dogfoodingVersion = "2.0.0-SNAPSHOT.063"
 
     /**
      * The version to be used for integration tests.
      */
-    const val version = "2.0.0-SNAPSHOT.062"
+    const val version = "2.0.0-SNAPSHOT.063"
 
     /**
      * The ID of the Gradle plugin.

buildSrc/src/main/kotlin/io/spine/dependency/local/Time.kt

@@ -40,7 +40,7 @@ import io.spine.dependency.Dependency
 )
 object Time : Dependency() {
     override val group = Spine.group
-    override val version = "2.0.0-SNAPSHOT.235"
+    override val version = "2.0.0-SNAPSHOT.238"
     private const val infix = "spine-time"
 
     fun lib(version: String): String = "$group:$infix:$version"
@@ -56,6 +56,12 @@ object Time : Dependency() {
     fun testLib(version: String): String = "${Spine.toolsGroup}:time-testlib:$version"
     val testLib get() = testLib(version)
 
+    fun validation(version: String): String = "${Spine.toolsGroup}:time-validation:$version"
+    val validation get() = validation(version)
+
+    fun gradlePlugin(version: String): String = "${Spine.toolsGroup}:time-gradle-plugin:$version"
+    val gradlePlugin get() = gradlePlugin(version)
+
     override val modules: List<String>
         get() = listOf(
             lib,

buildSrc/src/main/kotlin/io/spine/dependency/local/Validation.kt

@@ -36,7 +36,7 @@ object Validation {
     /**
      * The version of the Validation library artifacts.
      */
-    const val version = "2.0.0-SNAPSHOT.413"
+    const val version = "2.0.0-SNAPSHOT.414"
 
     /**
      * The last version of Validation compatible with ProtoData.