Skip to content

Wire private AI skills submodule (.dspace-skills)#1324

Merged
milanmajchrak merged 1 commit into
dtq-devfrom
add_dspace-skills_submodule
Jun 25, 2026
Merged

Wire private AI skills submodule (.dspace-skills)#1324
milanmajchrak merged 1 commit into
dtq-devfrom
add_dspace-skills_submodule

Conversation

@jr-rk

@jr-rk jr-rk commented Jun 25, 2026

Copy link
Copy Markdown

Problem description

Wire private .dspace-skills submodule to DSpace app.

Analysis

(Write here, if there is needed describe some specific problem. Erase it, when it is not needed.)

Problems

(Write here, if some unexpected problems occur during solving issues. Erase it, when it is not needed.)

Copilot review

  • Requested review from Copilot

Summary by CodeRabbit

  • Documentation
    • Added contributor guidance for using the new private skills submodule when available.
    • Clarified fallback behavior for environments without submodule access.
    • Documented how to load the appropriate frontend or backend profile and where to start common tasks.

@jr-rk jr-rk requested a review from Copilot June 25, 2026 11:22
@jr-rk jr-rk self-assigned this Jun 25, 2026
@coderabbitai

coderabbitai Bot commented Jun 25, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Adds a .gitmodules entry for .dspace-skills, updates the submodule pointer, and adds AGENTS.md/CLAUDE.md instructions for using the submodule when present and falling back when it is absent.

Changes

dspace-skills submodule setup

Layer / File(s) Summary
Submodule registration and pinning
.gitmodules, .dspace-skills
.gitmodules adds the .dspace-skills entry with path, URL, and branch, and the submodule pointer is updated to 2a62a2ebff88a05acf78d374003032b455843066.
Agent guide instructions
AGENTS.md, CLAUDE.md
AGENTS.md and CLAUDE.md add .dspace-skills loading instructions, profile selection, skill sourcing, task kickoff from SKILLS.md, and fallback behavior when the submodule is absent.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely describes the main change: wiring the private .dspace-skills submodule.
Description check ✅ Passed The description follows the required template and includes the problem statement plus Copilot review status.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR wires in a private, team-internal AI knowledge base by adding a new .dspace-skills/ git submodule and documenting how contributors/agents should consume it when available.

Changes:

  • Add .dspace-skills submodule entry to .gitmodules.
  • Add top-level documentation (AGENTS.md, CLAUDE.md) describing how to initialize and use .dspace-skills/.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File Description
CLAUDE.md Adds guidance on using the private .dspace-skills/ submodule when present.
AGENTS.md Adds the same guidance block for agent-related workflows.
.gitmodules Registers the .dspace-skills submodule (path/url/branch).

Comment thread .gitmodules
Comment thread CLAUDE.md
Comment thread AGENTS.md
Comment thread AGENTS.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
.gitmodules (1)

4-7: 🩺 Stability & Availability | 🔵 Trivial

Address missing SSH authentication for private submodules in CI.

The addition of submodules: 'recursive' in workflows like .github/workflows/create_bitstreams.yml and .github/actions/import-db/action.yml will fail because .gitmodules references the private submodule via SSH (git@github.com:dataquest-dev/dspace-skills.git). Configure the checkout step to inject an SSH private key or switch the URL to HTTPS with a token to ensure successful checkout in CI.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.gitmodules around lines 4 - 7, The recursive submodule checkout will fail
because the .gitmodules entry for .dspace-skills points to a private SSH URL, so
update the CI checkout setup in the affected workflows/actions (for example,
create_bitstreams and import-db) to provide SSH authentication or use an HTTPS
URL with a token. Make sure the checkout step can authenticate before fetching
submodules, and keep the submodule reference consistent with the private
repository access method.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.dspace-skills:
- Line 1: The `.dspace-skills` submodule configuration is using a private
SSH-only source that breaks recursive checkout in public clones and CI. Update
the submodule setup by either changing the `.gitmodules` entry for
`.dspace-skills` to an HTTPS/token-friendly URL, or by wiring the workflows that
use recursive submodules (for example, the ones that check out the repo and run
`submodules: 'recursive'`) to provide the needed SSH deploy key or token; if the
submodule is not required, remove the `.dspace-skills` reference entirely.

---

Nitpick comments:
In @.gitmodules:
- Around line 4-7: The recursive submodule checkout will fail because the
.gitmodules entry for .dspace-skills points to a private SSH URL, so update the
CI checkout setup in the affected workflows/actions (for example,
create_bitstreams and import-db) to provide SSH authentication or use an HTTPS
URL with a token. Make sure the checkout step can authenticate before fetching
submodules, and keep the submodule reference consistent with the private
repository access method.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0f18f282-05a9-465a-9e1e-4cc449df2665

📥 Commits

Reviewing files that changed from the base of the PR and between 1c285b4 and 58dcf82.

📒 Files selected for processing (4)
  • .dspace-skills
  • .gitmodules
  • AGENTS.md
  • CLAUDE.md

Comment thread .dspace-skills
@@ -0,0 +1 @@
Subproject commit 2a62a2ebff88a05acf78d374003032b455843066

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🩺 Stability & Availability | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Inspect the .gitmodules entry for .dspace-skills (url, branch, update/shallow settings)
fd -H -t f '^\.gitmodules$' --exec cat -n {}

# Check CI configs for how submodules are initialized (fatal vs. non-fatal, auth)
fd -H -t f -e yml -e yaml . .github 2>/dev/null --exec sh -c 'echo "=== {} ==="; rg -n -C2 "submodule" "{}"'
rg -n -C2 "submodule" -g '!**/node_modules/**' .circleci .github 2>/dev/null

Repository: dataquest-dev/dspace-angular

Length of output: 2373


The private .dspace-skills submodule configuration will break public clones and CI pipelines.

The .gitmodules file defines .dspace-skills with the SSH URL git@github.com:dataquest-dev/dspace-skills.git and branch main. Because this repo uses submodules: 'recursive' in workflows like .github/workflows/create_bitstreams.yml and .github/actions/import-db/action.yml, any runner or user without SSH credentials to dataquest-dev/dspace-skills.git will encounter a fatal error during the checkout process. This prevents external contributors from cloning the repository and may cause CI jobs to fail if the runners are not explicitly provisioned with access to this private submodule.

Please either:

  1. Configure the required workflows to inject an SSH deploy key or GITHUB_TOKEN specifically for this submodule.
  2. Switch the .gitmodules URL to HTTPS if the submodule is intended to be public or accessible via tokens.
  3. Remove the submodule reference if it is not a hard dependency for the build.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.dspace-skills at line 1, The `.dspace-skills` submodule configuration is
using a private SSH-only source that breaks recursive checkout in public clones
and CI. Update the submodule setup by either changing the `.gitmodules` entry
for `.dspace-skills` to an HTTPS/token-friendly URL, or by wiring the workflows
that use recursive submodules (for example, the ones that check out the repo and
run `submodules: 'recursive'`) to provide the needed SSH deploy key or token; if
the submodule is not required, remove the `.dspace-skills` reference entirely.

@jr-rk jr-rk requested a review from milanmajchrak June 25, 2026 11:26
@milanmajchrak milanmajchrak merged commit 778d878 into dtq-dev Jun 25, 2026
6 checks passed
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.

3 participants