Files
werkkompass/docs/werkkompass.werkbaum

70 lines
3.5 KiB
Plaintext

%% Werkkompass, planned with Werkbaum (https://werkbaum.javagil.de): what exists, what comes next.
%% Status: [^] deployed and in use, [x] merged but not deployed, [~] in work, [ ] planned, [?] idea, [-] dropped.
%% Each PR updates this file with the status its merge brings. The block behind --- explains the nodes with an id.
[~] #werkkompass: Werkkompass https://git.javagil.de/mi/werkkompass
- [^] #views: Views of the demo https://javagil.de/vibe-engineering
" One HTML file, published on 2026-09-07 as vibe-engineering.html.
- [^] #views.profiles: Agentic AI Software Development Profiles (M)
- [^] #views.staircase: Engineering Activities by Software Criticality (S)
- [^] #views.workflow: My Agentic AI Workflow (S)
- [x] #views.stair-roles: The staircase tells frontend and backend apart by authorship (XS)
" werkkompass PR#3: code review AI + Human; for a frontend no contract review and AI behavior tests.
- [~] #repo: Repository
- [x] #repo.takeover: The published page taken over unchanged (XS)
" Commit 27da462 on main, byte-identical with javagil.de/vibe-engineering.
- [x] #repo.foundation: Project foundation (S)
" werkkompass PR#1: README, AGENTS.md, workflow, PR documents, plan, risk analysis, review rules.
- [ ] #repo.sources: Readable sources, built into one installable HTML file (M)
- [ ] #repo.check: Automated check and Werkator build (S)
- [x] #bug: Fixes
- [x] #bug.frame-links: The links of the framed views open in the top window (XS)
" werkkompass PR#2.
- [x] #bug.back-href: The back arrow of the workflow view names the current file (XS)
" werkkompass PR#2.
- [ ] #ui: User interface
- [ ] #ui.brand: Branding as Werkkompass (S)
- [ ] #ui.i18n: DE/EN switch throughout (M)
- [ ] #ops: Operation
- [ ] #ops.domain: Served at werkkompass.javagil.de (S)
- [ ] #ops.deploy: Werkator deploys main after the merge (S)
- [?] #demos: More interactive demos on Vibe Engineering and Agentic AI
---
#repo.sources
HTML, CSS and JavaScript in files of their own, the two srcdoc views as
documents of their own, and a small reproducible build step without a
framework. The output stays one HTML file that
install-vibe-engineering-webapp accepts. The behaviour stays the same.
#repo.check
Added together with the build step, by decision of the human on
2026-10-14; the tool for both needs the human's decision.
#bug.frame-links
The copyright, imprint and privacy links of the staircase and the workflow
view load inside their iframe; michael.hoennig.de refuses to be framed, so
the view turns blank. Found in the browser check of werkkompass PR#1.
#bug.back-href
The fallback href of the back arrow is
agentic-ai-software-development.html#engineering-activities; the script
prevents it, but a middle click opens a missing page on javagil.de.
#ops.domain
Decided by the human on 2026-10-14: an own subdomain like
werkbaum.javagil.de and werkregie.javagil.de. The old address
javagil.de/vibe-engineering redirects there permanently (301). First the
human sets up the subdomain and a Unix user for it at Hostsharing; then
install-vibe-engineering-webapp gets the new target.
#ops.deploy
So far the human installs by hand with install-vibe-engineering-webapp.
A deploy build needs SSH access from Werkator on mih09 to the web space.
#ui.i18n
The profiles and the staircase view are in English, the workflow view is
mostly in German. The documents of the repository are in English and get
a German version later.