Skip to content

How we practice filling iCIMS job applications (plain-language)

This is the plain-English version of the iCIMS automation notes. If you want the code-level detail, see docs/technical/scraper-automation-learnings-icims.md.

The short version

Job sites run on different "application systems" (called ATS). We've built little practice gyms — one per system — where WorkWingman rehearses filling out an application over and over against a fake copy that lives entirely on your own computer. Nothing real is touched. This one is for iCIMS, which is the hardest system to automate.

Why iCIMS is the tough one

Most application systems put the form right on the page, where it's easy to find. iCIMS does four awkward things at once:

  1. It hides the form inside a "window within the window." Think of a page that has a smaller framed page embedded inside it (like a video embedded in an article). The real form lives inside that inner frame — and sometimes inside a second frame nested inside the first. If you look only at the outer page, you see nothing. You have to "step into" the frame first.
  2. The form fields have long, computer-generated name tags that change from company to company. You can't memorize them; you have to match on a recognizable piece of the tag.
  3. The layout is built out of old-fashioned tables, so you can't rely on the page's structure — only on the labels next to each box.
  4. It forces you to create an account before you can even see the form. (Our practice version only pretends to do this locally — it never creates a real account anywhere.)

What the practice gym does

Each practice round:

  1. Opens a fake iCIMS page that lives only on your computer.
  2. Steps into the hidden frame(s) to find the real form — and figures out on its own whether it needs to step in once, twice, or not at all.
  3. Pretends to create the required account (locally only — nothing real).
  4. Fills in the contact page, finds the resume upload box (but never uploads anything real), and answers the questions.
  5. Hits the classic tricky spot: the degree dropdown. Andrew's degree is "B.S. Game Development," and the company's list often doesn't have that exact wording. Rather than guess wrong, WorkWingman stops and asks which option to pick. (In practice mode it picks the closest match and writes down the choice; in real use it would pause and ask you.)
  6. Reaches the final "Submit" button, writes down "would submit (suppressed)," and does NOT click it. Then it starts over with a slightly different fake page.

Every round it shuffles the details — where the form is hidden, how the fields are named, how fast the page loads — so WorkWingman gets practice against all the messy shapes real iCIMS pages take.

What we learned

  • Stepping into the frame is the whole ballgame. The biggest early mistake was checking for the form before the inner frame had finished loading — like reaching for a door before it's fully open. The fix was to wait for the frame to be ready first. After that, the practice runs found the form correctly every single time, across all the hidden-frame shapes.
  • Old pages leave copies lying around. iCIMS keeps earlier pages in the background (just hidden from view), and their "Continue" buttons share the same name tag as the current one. WorkWingman was accidentally grabbing a hidden, dead button and getting stuck. The fix: always pick the button you can actually see.
  • When in doubt about the degree, ask — don't guess. This is the same safety rule as every other system: a low-confidence answer pauses for a human instead of picking something wrong.

Is any of this risky? No.

  • Everything happens on a fake page on your own computer. The internet is never touched.
  • No real iCIMS site, no real account, nothing submitted. The "create account" and "submit" steps are fakes that just log what they would do.
  • In a full 20-round practice session, every single round finished cleanly and every single one ended with "would submit (suppressed)" — proof the real submit button is never pressed.

The takeaway: iCIMS is the messiest system out there, and the practice gym taught WorkWingman how to handle its hidden frames, its confusing field names, and its forced account step — all safely, offline, with the final "Submit" always left for you to press.