Not sure what I'm doing wrong...

[rwebb616]

I have Aspens scanning my codebase and it picks up the tech stack but it can't find any code files - it's C# but I'm wondering if it's the directory structure. It's set up like this:

~/apps/myproject (claude.md lives here as well as my git setup
~/apps/myproject/myproject (this is the actual source code where the .csproj is at.

When it goes through with doc init it finds zero domains.

Any help?

[mvoutov]

hey -- interesting, the graph won't find C# natively since it isn't supported but that should not matter as much because doc init uses graph as the first layer, then Claude Code to discover the domains with higher quality.

Try running: aspens doc init ~/apps/myproject/myproject (the inner dir)

Although, it should have worked without going down an extra layer. You have Claude Code installed right ?

Let me know if this works. If not, we can try to find another solution.

[mvoutov]

No I don't think so. I think you need to run npm/npx aspens update (and you should see 0.7.2 version)

[rwebb616]

Actually it looks like it was npx update aspens and it looks like I have version 0.7.4 downloading right now.

[rwebb616]

Nevermind - no that was not it. I guess npm install -g aspens is the ticket... now it's saying 0.7.2 as you said.

[rwebb616]

It now appears to be working better - found 3 domains this time.

[mvoutov]

You can add more domains manually, but it has to have a directory, or else it won't recognize it.

aspens scan --domains "backtest,advisory"
aspens doc init --mode chunked --domains "auth,payments"

From Claude:
How it works (src/lib/scanner.js:36 — mergeExtraDomains):

• Each name is resolved first against the detected source root, then the repo root.
• If a matching directory is found, modules are collected and the domain is added with userSpecified: true.
• If no directory matches, it's still added as an empty user-specified domain.

[rwebb616]

So now is this supposed to auto run somehow when I do a git commit?

[mvoutov]

aspens doc sync --install-hook Enable/repair automatic doc updates after commits

[mvoutov]

Try it out and let me know. It has been a bit annoying, if I am honest, because it runs after you commit, so your updated skills show in uncommitted changes and you need to commit them after. Maybe there is a better way.

[rwebb616]

Ok I ran it and the dry-run looks like it generated a new claude.md (I mean I know it didn't because of dry-run but it showed what it would do) then I ran it for real and got this:

  Languages: csharp
  Source modules: data, models, services
  Import graph: 0 files, 0 edges
  Size: 31 source files (small)
  Timeout: 300s per call

│
◇  Existing Claude docs found. Skip discovery and reuse existing domains?
│  No
│
◇  Existing CLAUDE.md and/or skills detected. How to proceed:
│  Improve existing (recommended)
│
◇  3 domains detected. Generate skills:
│  All at once
│
●  Using existing Claude Code docs as improvement context.
│
◇  Generated 0 files
  1 Claude call(s) made, but no parseable output.

[mvoutov]

I think probably timed out ?

• for domains to generate skills, use one call per skill.

also add at the end --timeout <s> Seconds per call say 600, so it does not timeout.

[mvoutov]

try this aspens doc init --mode chunked -- this will use one call per skill

[rwebb616]

That looks like it worked. 3 domains analyzed hooks updated where supported .. now let's see how it does next time I add something.

[mvoutov]

okay, im glad! I hope it works out for you :) Don't hesitate to reach out if something does not look right. Or if you think or any improvements.